Method

GtkIMContextdelete_surrounding

Declaration [src]

gboolean
gtk_im_context_delete_surrounding (
  GtkIMContext* context,
  int offset,
  int n_chars
)

Description [src]

Asks the widget that the input context is attached to delete characters around the cursor position by emitting the ::delete_surrounding signal.

Note that offset and n_chars are in characters not in bytes which differs from the usage other places in GtkIMContext.

In order to use this function, you should first call gtk_im_context_get_surrounding() to get the current context, and call this function immediately afterwards to make sure that you know what you are deleting. You should also account for the fact that even if the signal was handled, the input context might not have deleted all the characters that were requested to be deleted.

This function is used by an input method that wants to make substitutions in the existing text in response to new input. It is not useful for applications.

Parameters

offset

Type: int

Offset from cursor position in chars; a negative value means start before the cursor.

n_chars

Type: int

Number of characters to delete.

Return value

Type: gboolean

TRUE if the signal was handled.