GtkIMContextget_surrounding

已弃用：4.2

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

检索插入点的上下文。

输入法通常需要上下文来依据现有文本约束输入文本；这在像泰语这样的语言中很重要，其中只有一些字符序列是被允许的。

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

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

自 4.2 版本以来已弃用

text

类型： char**

存储围绕插入点的文本的 UTF-8 编码字符串的位置。如果函数返回 TRUE，则必须使用 g_free() 释放此位置中存储的结果。

此参数将由函数设置。

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

这是一个以空字符终止的 UTF-8 字符串。

cursor_index

类型： int*

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

此参数将由函数设置。

类型： gboolean

TRUE 如果提供了周围文本；在这种情况下，您必须使用 text 中的结果进行释放。