Signal

GtkEditable::insert-text

Declaration

void
insert_text (
  GtkEditable* self,
  gchar* new_text,
  gint new_text_length,
  gint* position,
  gpointer user_data
)

Description [src]

This signal is emitted when text is inserted into the widget by the user. The default handler for this signal will normally be responsible for inserting the text, so by connecting to this signal and then stopping the signal with g_signal_stop_emission(), it is possible to modify the inserted text, or prevent it from being inserted entirely.

Default handler:

The default handler is called after the handlers added via g_signal_connect().

Parameters

new_text gchar*
 

The new text to insert.

 The data is owned by the caller of the function.
 The string is a NUL terminated UTF-8 string.
new_text_length gint
 

The length of the new text, in bytes, or -1 if new_text is nul-terminated.

position gint*
 

The position, in characters, at which to insert the new text. this is an in-out parameter. After the signal emission is finished, it should point after the newly inserted text.

 The argument will be modified by the function.
 The called function takes ownership of the data, and is responsible for freeing it.