方法
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 版本以来已弃用
[−]
参数
text-
类型：
char**存储 UTF-8 编码的字符串的内存位置，该字符串持有插入点周围的上下文。如果函数返回
TRUE，那么您必须使用g_free()来释放此位置中存储的结果。该参数将由函数设置。 方法调用者将拥有返回数据的所有权，并负责释放它。 该值是一个以 NUL 结尾的 UTF-8 字符串。 cursor_index-
类型：
int*存储文本中插入光标字节索引的内存位置。
该参数将由函数设置。