diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md b/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md index a444ba50565a8415d49443d747f94cd640019ae5..7450e05a7f0479f457f730f6cb42b5a097ad4411 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md @@ -1,27 +1,26 @@ # @ohos.multimodalInput.inputMonitor (输入监听) -输入监听模块，提供了监听输入设备事件（当前支持触屏、鼠标和触控板手势）的能力。 +输入监听模块，提供了监听输入设备事件的能力。输入设备事件当前包括触摸（触屏）事件、鼠标输入事件和触控板输入事件。 -> **说明：** +>**说明：** > -> - 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 +>- 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 > -> - 本模块接口均为系统接口。 - +>- 本模块接口均为系统接口。 +> +>- 文档中“全局”表示整个触控屏或触控板。如监听全局触摸事件，表示触摸触控板任何位置，整个触控板的触摸事件均被监听。 ## 导入模块 - ```js import inputMonitor from '@ohos.multimodalInput.inputMonitor'; ``` - ## inputMonitor.on('touch') on(type: 'touch', receiver: TouchEventReceiver): void -监听全局触屏事件。 +监听全局触摸（触屏）事件。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -31,7 +30,7 @@ on(type: 'touch', receiver: TouchEventReceiver): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“touch”。 | +| type | string | 是 | 输入设备事件类型，取值'touch'。 | | receiver | [TouchEventReceiver](#toucheventreceiver) | 是 | 回调函数，异步上报触摸屏输入事件。 | **示例：** @@ -61,7 +60,7 @@ on(type: 'mouse', receiver: Callback<MouseEvent>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“mouse”。 | +| type | string | 是 | 输入设备事件类型，取值'mouse'。 | | receiver | Callback<MouseEvent> | 是 | 回调函数，异步上报鼠标输入事件。 | **示例：** @@ -77,13 +76,11 @@ try { } ``` - - ## inputMonitor.off('touch') off(type: 'touch', receiver?: TouchEventReceiver): void -取消监听全局触屏事件。 +取消监听全局触摸事件。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -93,8 +90,8 @@ off(type: 'touch', receiver?: TouchEventReceiver): void | 参数名 | 类型 | 必填 | 说明 | | -------- | ---------------------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“touch”。 | -| receiver | [TouchEventReceiver](#toucheventreceiver) | 否 | 需要取消监听的回调函数，若无此参数，则取消当前应用监听的所有回调函数。 | +| type | string | 是 | 输入设备事件类型，取值'touch'。 | +| receiver | [TouchEventReceiver](#toucheventreceiver) | 否 | 需要取消监听的回调函数。若不填，则取消当前应用监听的所有回调函数。 | **示例：** @@ -142,8 +139,8 @@ off(type: 'mouse', receiver?: Callback<MouseEvent>): void | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“mouse”。 | -| receiver | Callback<MouseEvent> | 否 | 需要取消监听的回调函数，若无此参数，则取消当前应用监听的所有回调函数。 | +| type | string | 是 | 输入设备事件类型，取值'mouse'。 | +| receiver | Callback<MouseEvent> | 否 | 需要取消监听的回调函数。若不填，则取消当前应用监听的所有回调函数。 | **示例：** @@ -179,7 +176,7 @@ try { ## TouchEventReceiver -触摸输入事件的回调函数。 +触摸（触屏）输入事件的回调函数。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -216,7 +213,7 @@ try { on(type: 'pinch', receiver: Callback<[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)>): void -监听全局的触控板捏合事件。 +监听全局触控板的捏合事件。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -226,7 +223,7 @@ on(type: 'pinch', receiver: Callback<[Pinch](js-apis-multimodalinput-gesturee | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“pinch”。 | +| type | string | 是 | 输入设备事件类型，取值'pinch'。 | | receiver | Callback<[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)> | 是 | 回调函数，异步上报捏合输入事件。 | **示例：** @@ -246,7 +243,7 @@ try { off(type: 'pinch', receiver?: Callback<[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)>): void -取消监听全局的触控板捏合事件。 +取消监听全局触控板的捏合事件。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -256,8 +253,8 @@ off(type: 'pinch', receiver?: Callback<[Pinch](js-apis-multimodalinput-gestur | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“pinch”。 | -| receiver | Callback<[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)> | 否 | 需要取消监听的回调函数，若无此参数，则取消当前应用监听的所有回调函数。 | +| type | string | 是 | 输入设备事件类型，取值'pinch'。 | +| receiver | Callback<[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)> | 否 | 需要取消监听的回调函数。若不填，则取消当前应用监听的所有回调函数。 | **示例：** @@ -295,7 +292,7 @@ try { on(type: 'threeFingersSwipe', receiver: Callback<[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)>): void -监听全局的触控板三指滑动事件。 +监听全局触控板的三指滑动事件。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -305,7 +302,7 @@ on(type: 'threeFingersSwipe', receiver: Callback<[ThreeFingersSwipe](js-apis- | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“threeFingersSwipe”。 | +| type | string | 是 | 输入设备事件类型，取值'threeFingersSwipe'。 | | receiver | Callback<[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)> | 是 | 回调函数，异步上报三指滑动输入事件。 | **示例：** @@ -325,7 +322,7 @@ try { off(type: 'threeFingersSwipe', receiver?: Callback<[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)>): void -取消监听全局的触控板三指滑动事件。 +取消监听全局触控板的三指滑动事件。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -335,8 +332,8 @@ off(type: 'threeFingersSwipe', receiver?: Callback<[ThreeFingersSwipe](js-api | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“threeFingersSwipe”。 | -| receiver | Callback<[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)> | 否 | 需要取消监听的回调函数，若无此参数，则取消当前应用监听的所有回调函数。 | +| type | string | 是 | 输入设备事件类型，取值'threeFingersSwipe'。 | +| receiver | Callback<[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)> | 否 | 需要取消监听的回调函数。若不填，则取消当前应用监听的所有回调函数。 | **示例：** @@ -374,7 +371,7 @@ try { on(type: 'fourFingersSwipe', receiver: Callback<[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)>): void -监听全局的触控板四指滑动事件。 +监听全局触控板的四指滑动事件。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -384,7 +381,7 @@ on(type: 'fourFingersSwipe', receiver: Callback<[FourFingersSwipe](js-apis-mu | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“fourFingersSwipe”。 | +| type | string | 是 | 输入设备事件类型，取值'fourFingersSwipe'。 | | receiver | Callback<[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)> | 是 | 回调函数，异步上报四指滑动输入事件。 | **示例：** @@ -404,7 +401,7 @@ try { off(type: 'fourFingersSwipe', receiver?: Callback<[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)>): void -取消监听全局的触控板四指滑动事件。 +取消监听全局触控板的四指滑动事件。 **需要权限：** ohos.permission.INPUT_MONITORING @@ -414,8 +411,8 @@ off(type: 'fourFingersSwipe', receiver?: Callback<[FourFingersSwipe](js-apis- | 参数名 | 类型 | 必填 | 说明 | | -------- | -------------------------- | ---- | ------------------- | -| type | string | 是 | 输入设备事件类型，取值“fourFingersSwipe”。 | -| receiver | Callback<[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)> | 否 | 需要取消监听的回调函数，若无此参数，则取消当前应用监听的所有回调函数。 | +| type | string | 是 | 输入设备事件类型，取值'fourFingersSwipe'。 | +| receiver | Callback<[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)> | 否 | 需要取消监听的回调函数。若不填，则取消当前应用监听的所有回调函数。 | **示例：**