Method

GtkIMContextset_surrounding

deprecated: 4.2

Declaration [src]

void
gtk_im_context_set_surrounding (
  GtkIMContext* context,
  const char* text,
  int len,
  int cursor_index
)

Description [src]

Sets surrounding context around the insertion point and preedit string.

This function is expected to be called in response to the GtkIMContext::retrieve-surrounding signal, and will likely have no effect if called at other times.

Deprecated since: 4.2

Use gtk_im_context_set_surrounding_with_selection() instead.

Parameters

text

Type: const char*

Text surrounding the insertion point, as UTF-8. the preedit string should not be included within text.

The data is owned by the caller of the method.

The value is a NUL terminated UTF-8 string.

len

Type: int

The length of text, or -1 if text is nul-terminated.

cursor_index

Type: int

The byte index of the insertion cursor within text.