方法

GtkIMContextget_surrounding_with_selection

since: 4.2

声明 [src]

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

描述 [src]

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

输入方法通常需要上下文,以便根据现有文本约束输入文本;这对于泰语等只有一些字符序列被允许的语言非常重要。

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

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

自 4.2 版本起可用

参数

文本

类型: char**

存储包含插入点周围上下文的 UTF-8 编码字符串的位置。如果函数返回 TRUE,则您必须使用 g_free() 释放此位置中存储的结果。

该参数将由函数设置。
方法调用者负责释放返回的数据。
该值是一个以 NUL 结尾的 UTF-8 字符串。
光标索引

类型: int*

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

该参数将由函数设置。
锚点索引

类型: int*

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

该参数将由函数设置。

返回值

类型: gboolean

TRUE 如果提供了周围文本;在此情况下,您必须释放存储在 文本 中的结果。