ime.updateGeometry()

把当前插入点、编辑区域和可选字符矩形同步给宿主，用于定位软键盘与候选窗口。

Syntax

await host.ime.updateGeometry(session, geometry);

Parameters

geometry 使用模块页定义的 ImeGeometry。几何使用对应 canvas 的逻辑像素；字符项按 UTF-16 起始 offset 严格递增，且只能覆盖当前 revision 中的 Unicode 标量起点。

Examples

await host.ime.updateGeometry(session, {
  editorBounds: layout.editorBounds,
  caretBounds: layout.caretBounds,
  revision: editor.revision,
});

布局或 canvas.resize 后应更新；无需在每个动画帧重复发送相同数据。

Return value

无。

Errors

特有错误：stale-handle、resource-denied、stale-state、invalid-geometry、limit-exceeded。

Requirements

• 授权：handle-derived，需要活动 ime-session 的 rw 权限
• 用户激活：不需要
• 信任档位：green

See also

ime.characterBoundsRequest、canvas.resize