input.focus()

请求把键盘和指针输入焦点交给本应用的指定绘图面。宿主可以因后台状态、可信 UI 覆盖或系统策略拒绝。

Syntax

await host.input.focus(canvasId);

Parameters

canvasId: string：本应用仍然存活且可聚焦的绘图面。

Return value

无。成功表示焦点请求已被宿主接受；随后的输入仍取决于用户和系统状态。

Examples

async function activateEditor() {
  await host.input.focus('editor');
  drawFocusRing();
}

Errors

not-found、not-visible、denied、limit-exceeded。不能用它从后台抢占系统焦点。

Requirements

• 能力：host:input.focus
• 用户激活：通常需要当前应用交互上下文
• 信任档位：green

See also

input.key、ime.openSession()