Gtk.IMContext.set_surrounding

### Method

# Gtk IMContextset_surrounding

#### 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` | `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 function.
| The value is a NUL terminated UTF-8 string.
`len` | `int`
| The length of `text`, or -1 if `text` is nul-terminated.
`cursor_index` | `int`
| The byte index of the insertion cursor within `text`.