方法
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*
存储文本中插入光标字节索引的内存位置。
该参数将由函数设置。