GtkIMContextget_surrounding_with_selection

自：4.2

gboolean
get_surrounding_with_selection (
  GtkIMContext* context,
  char** text,
  int* cursor_index,
  int* anchor_index
)

检索插入点周围的上下文。

输入法通常需要上下文以根据现有文本限制输入文本；这对于如泰语这样的需要限制字符序列的语言来说很重要。

此函数通过在输入法上发出 GtkIMContext::retrieve-surrounding 信号来实现；对此信号的响应，小部件应通过调用 gtk_im_context_set_surrounding_with_selection() 来提供尽可能多的上下文，直至整个段落。

请注意，不需要小部件响应 ::retrieve-surrounding 信号，因此输入法必须准备在没有上下文的情况下运行。

自：4.2

text

类型： char**

存储包含插入点周围上下文的UTF-8编码字符串的位置。

此参数将被函数设置。

调用此方法的调用者获得返回数据的所有权，并负责释放它。

该值是NULL终止的UTF-8字符串。

cursor_index

类型： int*

存储插入光标在text中的字节索引的位置。

此参数将被函数设置。

anchor_index

类型： int*

存储文本中选择边界字节索引的位置。

此参数将被函数设置。

类型： gboolean

TRUE 如果提供了上下文文本；在这种情况下，您必须调用 g_free() 释放存储在 text 中的结果。