### Virtual Method

# Gtk IMContext set_surrounding

deprecated: 4.2

#### Declaration [src]

    void
    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 function.
  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`.