目录

InputMethod_CursorInfo

typedef struct InputMethod_CursorInfo InputMethod_CursorInfo

概述

InputMethod_CursorInfo是光标信息的不透明类型(opaque type),用于描述文本输入时光标在物理屏幕上的位置和尺寸,包括光标的水平坐标(left)、垂直坐标(top)、宽度(width)和高度(height)。

用途:为输入法服务提供光标的精确位置和尺寸信息,输入法根据此信息实现以下功能:

使用场景:

  1. 在TextConfig中携带光标信息:应用在OH_TextEditorProxy_GetTextConfigFunc回调中返回TextConfig时,其中包含的CursorInfo告知输入法当前光标位置和尺寸。
  2. 主动通知光标更新:当光标位置发生变化时(如用户移动光标、文本插入导致光标偏移),应用通过OH_InputMethodProxy_NotifyCursorUpdate主动通知输入法最新的光标位置。

相关函数:

函数 说明
OH_CursorInfo_Create 创建CursorInfo实例,需传入left、top、width、height。
OH_CursorInfo_Destroy 销毁CursorInfo实例。
OH_CursorInfo_SetRect 设置光标的位置和尺寸。
OH_CursorInfo_GetRect 获取光标的位置和尺寸。

与其他结构体的关系:

起始版本: 12

相关模块: InputMethod

所在头文件: inputmethod_cursor_info_capi.h