信号

GtkEditable::insert-text

声明

void
insert_text (
  GtkEditable* self,
  gchar* text,
  gint length,
  gint* position,
  gpointer user_data
)

描述 [src]

当用户将文本插入小部件时发出。

此信号的默认处理程序通常负责插入文本,因此通过连接到此信号然后使用 g_signal_stop_emission() 停止信号,可以修改要插入的文本,或完全阻止其插入。

默认处理程序

默认处理程序在通过 g_signal_connect() 添加的处理程序之后调用。

参数

text

类型: gchar*

要插入的新文本。

数据由函数的调用者拥有。
该值是 NUL 终止的 UTF-8 字符串。
length

类型: gint

新文本的长度,以字节为单位,如果 new_text 是 NUL 终止的,则为 -1。

position

类型: gint*

插入新文本的位置,以字符为单位。这是一个输入-输出参数。在信号发出完成后,它应指向新插入的文本之后。

该参数将由函数修改。