Input method v1

发送提交字符串文本以插入到应用程序中。

要提交的文本可以是按键后的单个字符，也可以是某些组合（预编辑）的结果。当需要移除某些文本（参见 delete_surrounding_text）或需要移动输入光标（参见 cursor_position）时，也可以是空文本。

之前设置的任何组合文本将被移除。

向应用程序文本输入发送预编辑字符串文本。

提交文本可用于在重置时（例如取消焦点时）替换预编辑文本。

之前发送的 preedit_style 和 preedit_cursor 请求也会被 text_input 处理。

设置组合文本的样式信息。样式从索引开始以字节为单位应用于组合文本（作为字节偏移量）。可以将多种样式应用于组合文本。

此请求应在发送 preedit_string 请求之前发送。

设置组合文本内的光标位置（作为字节偏移量），相对于组合文本的开头。

当索引为负数时不应显示光标。

此请求应在发送 preedit_string 请求之前发送。

移除周围文本。

此请求将在 text_input 端直接在 commit_string 请求之后处理。

将光标和锚点设置到新位置。索引是新的光标位置（以字节为单位），当 >= 0 时相对于插入文本的末尾，否则相对于插入文本的开头）。锚点是新的锚点位置（以字节为单位），当 >= 0 时相对于插入文本的末尾，否则相对于插入文本的开头）。当不应有选定文本时，锚点应与索引相同。

此请求将在 text_input 端直接在 commit_string 请求之后处理。

通知按键事件已发送。按键事件不应用于正常的文本输入操作，这些操作应通过 commit_string、delete_surrounding_text 等完成。按键事件遵循 wl_keyboard 按键事件约定。Sym 是 XKB keysym，state 是 wl_keyboard key_state。

允许输入法接收硬件键盘输入并处理按键事件以在线生成文本事件（带预编辑）。这允许多个按键事件组合输入文本的输入法，如 CJK 语言所做的那样。

将输入法本身未处理的 wl_keyboard::key 事件转发给客户端。在使用 grab_keyboard 过滤按键事件时使用。参数应来自 wl_keyboard::key 事件。

要生成自定义按键事件，请改用 keysym 请求。

将输入法本身未处理的 wl_keyboard::modifiers 事件转发给客户端。在使用 grab_keyboard 过滤按键事件时使用。参数应来自 wl_keyboard::modifiers 事件。

输入位置周围的纯文本周围文本。光标是周围文本中相对于文本开头的字节位置。锚点是周围文本中选择锚点相对于文本开头的字节位置。如果没有选定文本，则锚点与光标相同。

文本输入已激活。创建一个输入法上下文对象，允许与文本输入通信。

与上下文参数对应的文本输入已停用。输入法上下文应在处理停用后销毁。

将 input_panel_surface 类型设置为键盘。

键盘表面仅在文本输入活动时显示。

将 input_panel_surface 设置为覆盖面板。

当文本输入活动时，此面板显示在应用程序窗口上方的输入光标附近。