方法

GtkIMContextget_surrounding

弃用：4.2 

声明 [源]

gboolean
gtk_im_context_get_surrounding (
  GtkIMContext* context,
  char** text,
  int* cursor_index
)

描述 [源]

获取插入点周围的内容。

输入法通常需要上下文来限制输入文本，基于现有文本；这对于像泰语这样的语言非常重要，其中只有一些字符序列是被允许的。

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

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

自 4.2 版本以来已弃用

请使用 gtk_im_context_get_surrounding_with_selection() 代替。

参数

text

类型： char**

存储 UTF-8 编码的字符串的内存位置，该字符串持有插入点周围的上下文。如果函数返回 TRUE，那么您必须使用 g_free() 来释放此位置中存储的结果。

该参数将由函数设置。
方法调用者将拥有返回数据的所有权，并负责释放它。
该值是一个以 NUL 结尾的 UTF-8 字符串。
cursor_index

类型： int*

存储文本中插入光标字节索引的内存位置。

该参数将由函数设置。

返回值

类型： gboolean

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