智能客服
你问我答，随时在线为你解决问题
- 对象为空对象，不包含任何可访问的成员。
- 开发者无法主动构造此对象，只能通过addLocalInputEventMonitor接口注册获取。
- 用于后续解除注册时验证身份。
- 探索了解鸿蒙应用和多设备开发，学习如何构建应用/元服务应用形态HarmonyOS 应用One as All，All as One
元服务秒开直达 服务随行 无处不在
游戏为游戏创意玩法带来无限可能
多设备应用开发穿戴
折叠屏手机鸿蒙电脑开发者学堂视频课程Codelabs - 开发获取官方开发工具和文档等资源，将创意转化为鸿蒙应用开发工具DevEco Studio应用开发 IDE, AI Agent 和 CLI
小艺开放平台Skill 和智能体开发平台
ArkTS
ArKUI
AppGallery ConnectDevEco Testing开发资源工具下载示例代码开发文档最佳实践 - 分发通过华为应用市场发布你的应用，多渠道触达用户应用分发应用市场纯净安全的全场景应用分发平台
游戏中心
应用审核政策服务分发小艺HarmonyOS 的超级 AI 入口
智慧助手·今天
服务分发文档内容分发主题服务
内容分发文档 - 推广与变现一站式流量增长与营销变现平台推广应用推广引擎全链路应用推广与增长服务平台
鲸鸿动能广告为企业广告主提供广告营销服务
联运服务推广文档变现鲸鸿动能流量变现使能应用展示广告，实现流量变现应用内支付变现文档 - 生态合作携手伙伴共建共享鸿蒙智能终端生态伙伴 SDK一站式获取安全可靠的鸿蒙伙伴 SDK
生态服务鸿蒙应用开发、培训和人力服务
服务商伙伴中心华为终端云服务商伙伴的统一门户
伙伴入驻指南生态市场介绍，卖家和买家服务指引
廉洁政策合作伙伴诚信廉洁政策
- 支持获取客服帮助、技术支持、活动资讯等信息智能客服24小时 AI 在线自助服务，即问即答
社区问答在官方论坛提问，与开发者互动交流
在线提单提交工单，获得技术支持
开发者活动HDD 等线下活动速览及报名入口
资讯帮助指南
全局基础输入事件监听
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
本文导读
监听基础输入事件，在UIContext进行事件分发前统一拦截和过滤输入事件，适用于全局快捷键处理、输入安全过滤、特定页面统一屏蔽鼠标、触摸或按键输入等需要在事件到达组件前进行统一管控的场景，使用示例请参考addLocalInputEventMonitor。
起始版本： 26.0.0
InputEventMonitor
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
输入事件监听器标识对象。
此对象由系统创建并返回，作为监听器的唯一标识。
说明
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
InputEventListener
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
type InputEventListener = (event: RawInputEventWrapper) => InputEventInterceptResult
输入事件监听器回调函数类型。
说明
- RawInputEventWrapper是抽象类，开发者无法使用new运算符创建实例。
- 系统会在事件触发时自动创建实例并通过此参数传递给回调函数。
- 当前回调参数event仅会封装以下原始输入事件类型：MouseEvent、TouchEvent、KeyEvent。开发者可通过asMouseEvent、asTouchEvent、asKeyEvent获取对应事件对象。
- 请勿在回调中执行耗时操作（如复杂计算或网络请求），否则可能导致应用卡顿。
- 监听器在UI线程中同步执行会直接阻塞事件处理流程。建议仅执行不会阻塞UI线程的本地条件判断和简单计算。
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| event | RawInputEventWrapper | 是 | 输入事件包装器，系统自动创建和传递，开发者无需手动创建。 |
返回值：
| 类型 | 说明 |
|---|---|
| InputEventInterceptResult | 事件拦截结果。 |
InputEventInterceptResult
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
输入事件拦截结果接口，用于监听器回调InputEventListener返回是否阻止事件传递的决策。
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| action | InputEventInterceptAction | 否 | 否 | 输入事件拦截动作。 CONTINUE：允许事件继续传递到UI框架。 BLOCK：阻止事件传递到UI框架。 |
RawInputEventWrapper
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
原始输入事件包装器类。
提供统一的接口来访问不同类型的输入事件，确保类型安全和向后兼容性。
此类封装了原始的MouseEvent、TouchEvent或KeyEvent对象，并通过类型安全的方法访问。
此类为抽象类，开发者无法自行创建实例。系统会在触发输入事件监听器时自动创建实例，并将实例传递给回调函数。
起始版本： 26.0.0
说明
由于监听器在事件派发给具体组件之前执行，事件中的以下字段和方法将无法提供有效值：触发对象target、相对于组件的坐标（x、y）、getCurrentLocalPosition和stopPropagation方法、TouchEvent的preventDefault和getHistoricalPoints方法以及KeyEvent的metaKey属性和getModifierKeyState方法。
示例：
const listener: InputEventListener = (wrapper: RawInputEventWrapper) => {
// 使用类型判断 + 获取事件对象
if (wrapper.isMouseEvent()) {
const mouseEvent = wrapper.asMouseEvent()!;
console.info(`Mouse: (${mouseEvent.windowX}, ${mouseEvent.windowY})`);
return { action: InputEventInterceptAction.CONTINUE };
}
if (wrapper.isTouchEvent()) {
const touchEvent = wrapper.asTouchEvent()!;
console.info(`Touch: ${touchEvent.touches.length} points`);
return { action: InputEventInterceptAction.CONTINUE };
}
if (wrapper.isKeyEvent()) {
const keyEvent = wrapper.asKeyEvent()!;
console.info(`Key: ${keyEvent.keyText}`);
return { action: InputEventInterceptAction.CONTINUE };
}
return { action: InputEventInterceptAction.CONTINUE };
}; isMouseEvent
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
isMouseEvent(): boolean
判断是否为鼠标事件。
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
返回值：
| 类型 | 说明 |
|---|---|
| boolean | 判断是否为鼠标事件，如果是鼠标事件则返回true，否则返回false。 |
isTouchEvent
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
isTouchEvent(): boolean
判断是否为触摸事件。
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
返回值：
| 类型 | 说明 |
|---|---|
| boolean | 判断是否为触摸事件，如果是触摸事件则返回true，否则返回false。 |
isKeyEvent
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
isKeyEvent(): boolean
判断是否为按键事件。
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
返回值：
| 类型 | 说明 |
|---|---|
| boolean | 判断是否为按键事件，如果是按键事件则返回true，否则返回false。 |
asMouseEvent
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
asMouseEvent(): MouseEvent | null
获取鼠标事件。
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
返回值：
| 类型 | 说明 |
|---|---|
| MouseEvent | null | 获取鼠标事件，如果是鼠标事件则返回事件对象，否则返回null。由于监听器在事件派发给具体组件之前执行，返回的MouseEvent中触发对象target、相对于组件的坐标x和y等字段无法提供有效值。 |
asTouchEvent
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
asTouchEvent(): TouchEvent | null
获取触摸事件。
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
返回值：
| 类型 | 说明 |
|---|---|
| TouchEvent | null | 获取触摸事件，如果是触摸事件则返回事件对象，否则返回null。由于监听器在事件派发给具体组件之前执行，返回的TouchEvent中getCurrentLocalPosition、stopPropagation、preventDefault和getHistoricalPoints等方法无法提供有效值。 |
asKeyEvent
Phone26.0.0+PC/2in126.0.0+Tablet26.0.0+TV26.0.0+Wearable26.0.0+
asKeyEvent(): KeyEvent | null
获取按键事件。
起始版本： 26.0.0
元服务API： 从API版本26.0.0开始，该接口支持在元服务中使用。
系统能力： SystemCapability.ArkUI.ArkUI.Full
模型约束： 此接口仅可在Stage模型下使用。
返回值：
| 类型 | 说明 |
|---|---|
| KeyEvent | null | 获取按键事件，如果是按键事件则返回事件对象，否则返回null。由于监听器在事件派发给具体组件之前执行，返回的KeyEvent中metaKey属性和getModifierKeyState方法无法提供有效值。 |
请输入您想要搜索的关键词