Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
e05fa1eb
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
e05fa1eb
编写于
8月 18, 2023
作者:
N
ningning
提交者:
Gitee
8月 18, 2023
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md.
Signed-off-by:
N
ningning
<
wangningning14@huawei.com
>
上级
e8ed7e6d
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
30 addition
and
33 deletion
+30
-33
zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md
zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md
+30
-33
未找到文件。
zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md
浏览文件 @
e05fa1eb
# @ohos.multimodalInput.inputMonitor (输入监听)
# @ohos.multimodalInput.inputMonitor (输入监听)
输入监听模块,提供了监听输入设备事件
(当前支持触屏、鼠标和触控板手势)的能力
。
输入监听模块,提供了监听输入设备事件
的能力。输入设备事件当前包括触摸(触屏)事件、鼠标输入事件和触控板输入事件
。
>
**说明:**
>**说明:**
>
>
>
- 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>- 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
>
>
> - 本模块接口均为系统接口。
>- 本模块接口均为系统接口。
>
>- 文档中“全局”表示整个触控屏或触控板。如监听全局触摸事件,表示触摸触控板任何位置,整个触控板的触摸事件均被监听。
## 导入模块
## 导入模块
```
js
```
js
import
inputMonitor
from
'
@ohos.multimodalInput.inputMonitor
'
;
import
inputMonitor
from
'
@ohos.multimodalInput.inputMonitor
'
;
```
```
## inputMonitor.on('touch')
## inputMonitor.on('touch')
on(type: 'touch', receiver: TouchEventReceiver): void
on(type: 'touch', receiver: TouchEventReceiver): void
监听全局触
屏
事件。
监听全局触
摸(触屏)
事件。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -31,7 +30,7 @@ on(type: 'touch', receiver: TouchEventReceiver): void
...
@@ -31,7 +30,7 @@ on(type: 'touch', receiver: TouchEventReceiver): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------- |
| -------- | ---------------------------------------- | ---- | ------------------- |
| type | string | 是 | 输入设备事件类型,取值
“touch”
。 |
| type | string | 是 | 输入设备事件类型,取值
'touch'
。 |
| receiver |
[
TouchEventReceiver
](
#toucheventreceiver
)
| 是 | 回调函数,异步上报触摸屏输入事件。 |
| receiver |
[
TouchEventReceiver
](
#toucheventreceiver
)
| 是 | 回调函数,异步上报触摸屏输入事件。 |
**示例:**
**示例:**
...
@@ -61,7 +60,7 @@ on(type: 'mouse', receiver: Callback<MouseEvent>): void
...
@@ -61,7 +60,7 @@ on(type: 'mouse', receiver: Callback<MouseEvent>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------- | ---- | ------------------- |
| -------- | -------------------------- | ---- | ------------------- |
| type | string | 是 | 输入设备事件类型,取值
“mouse”
。 |
| type | string | 是 | 输入设备事件类型,取值
'mouse'
。 |
| receiver | Callback
<
MouseEvent
>
| 是 | 回调函数,异步上报鼠标输入事件。 |
| receiver | Callback
<
MouseEvent
>
| 是 | 回调函数,异步上报鼠标输入事件。 |
**示例:**
**示例:**
...
@@ -77,13 +76,11 @@ try {
...
@@ -77,13 +76,11 @@ try {
}
}
```
```
## inputMonitor.off('touch')
## inputMonitor.off('touch')
off(type: 'touch', receiver?: TouchEventReceiver): void
off(type: 'touch', receiver?: TouchEventReceiver): void
取消监听全局触
屏
事件。
取消监听全局触
摸
事件。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -93,8 +90,8 @@ off(type: 'touch', receiver?: TouchEventReceiver): void
...
@@ -93,8 +90,8 @@ off(type: 'touch', receiver?: TouchEventReceiver): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ---------------------------------------- | ---- | ------------------- |
| -------- | ---------------------------------------- | ---- | ------------------- |
| type | string | 是 | 输入设备事件类型,取值
“touch”
。 |
| type | string | 是 | 输入设备事件类型,取值
'touch'
。 |
| receiver |
[
TouchEventReceiver
](
#toucheventreceiver
)
| 否 | 需要取消监听的回调函数
,若无此参数
,则取消当前应用监听的所有回调函数。 |
| receiver |
[
TouchEventReceiver
](
#toucheventreceiver
)
| 否 | 需要取消监听的回调函数
。若不填
,则取消当前应用监听的所有回调函数。 |
**示例:**
**示例:**
...
@@ -142,8 +139,8 @@ off(type: 'mouse', receiver?: Callback<MouseEvent>): void
...
@@ -142,8 +139,8 @@ off(type: 'mouse', receiver?: Callback<MouseEvent>): void
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------- | ---- | ------------------- |
| -------- | -------------------------- | ---- | ------------------- |
| type | string | 是 | 输入设备事件类型,取值
“mouse”
。 |
| type | string | 是 | 输入设备事件类型,取值
'mouse'
。 |
| receiver | Callback
<
MouseEvent
>
| 否 | 需要取消监听的回调函数
,若无此参数
,则取消当前应用监听的所有回调函数。 |
| receiver | Callback
<
MouseEvent
>
| 否 | 需要取消监听的回调函数
。若不填
,则取消当前应用监听的所有回调函数。 |
**示例:**
**示例:**
...
@@ -179,7 +176,7 @@ try {
...
@@ -179,7 +176,7 @@ try {
## TouchEventReceiver
## TouchEventReceiver
触摸输入事件的回调函数。
触摸
(触屏)
输入事件的回调函数。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -216,7 +213,7 @@ try {
...
@@ -216,7 +213,7 @@ try {
on(type: 'pinch', receiver: Callback
<
[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)
>
): void
on(type: 'pinch', receiver: Callback
<
[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)
>
): void
监听全局
的触控板
捏合事件。
监听全局
触控板的
捏合事件。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -226,7 +223,7 @@ on(type: 'pinch', receiver: Callback<[Pinch](js-apis-multimodalinput-gesturee
...
@@ -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)
>
| 是 | 回调函数,异步上报捏合输入事件。 |
| receiver | Callback
<
[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)
>
| 是 | 回调函数,异步上报捏合输入事件。 |
**示例:**
**示例:**
...
@@ -246,7 +243,7 @@ try {
...
@@ -246,7 +243,7 @@ try {
off(type: 'pinch', receiver?: Callback
<
[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)
>
): void
off(type: 'pinch', receiver?: Callback
<
[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)
>
): void
取消监听全局
的触控板
捏合事件。
取消监听全局
触控板的
捏合事件。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -256,8 +253,8 @@ off(type: 'pinch', receiver?: Callback<[Pinch](js-apis-multimodalinput-gestur
...
@@ -256,8 +253,8 @@ off(type: 'pinch', receiver?: Callback<[Pinch](js-apis-multimodalinput-gestur
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------- | ---- | ------------------- |
| -------- | -------------------------- | ---- | ------------------- |
| type | string | 是 | 输入设备事件类型,取值
“pinch”
。 |
| type | string | 是 | 输入设备事件类型,取值
'pinch'
。 |
| receiver | Callback
<
[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)
>
| 否 | 需要取消监听的回调函数
,若无此参数
,则取消当前应用监听的所有回调函数。 |
| receiver | Callback
<
[Pinch](js-apis-multimodalinput-gestureevent.md#pinch)
>
| 否 | 需要取消监听的回调函数
。若不填
,则取消当前应用监听的所有回调函数。 |
**示例:**
**示例:**
...
@@ -295,7 +292,7 @@ try {
...
@@ -295,7 +292,7 @@ try {
on(type: 'threeFingersSwipe', receiver: Callback
<
[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)
>
): void
on(type: 'threeFingersSwipe', receiver: Callback
<
[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)
>
): void
监听全局
的触控板
三指滑动事件。
监听全局
触控板的
三指滑动事件。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -305,7 +302,7 @@ on(type: 'threeFingersSwipe', receiver: Callback<[ThreeFingersSwipe](js-apis-
...
@@ -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)
>
| 是 | 回调函数,异步上报三指滑动输入事件。 |
| receiver | Callback
<
[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)
>
| 是 | 回调函数,异步上报三指滑动输入事件。 |
**示例:**
**示例:**
...
@@ -325,7 +322,7 @@ try {
...
@@ -325,7 +322,7 @@ try {
off(type: 'threeFingersSwipe', receiver?: Callback
<
[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)
>
): void
off(type: 'threeFingersSwipe', receiver?: Callback
<
[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)
>
): void
取消监听全局
的触控板
三指滑动事件。
取消监听全局
触控板的
三指滑动事件。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -335,8 +332,8 @@ off(type: 'threeFingersSwipe', receiver?: Callback<[ThreeFingersSwipe](js-api
...
@@ -335,8 +332,8 @@ off(type: 'threeFingersSwipe', receiver?: Callback<[ThreeFingersSwipe](js-api
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------- | ---- | ------------------- |
| -------- | -------------------------- | ---- | ------------------- |
| type | string | 是 | 输入设备事件类型,取值
“threeFingersSwipe”
。 |
| type | string | 是 | 输入设备事件类型,取值
'threeFingersSwipe'
。 |
| receiver | Callback
<
[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)
>
| 否 | 需要取消监听的回调函数
,若无此参数
,则取消当前应用监听的所有回调函数。 |
| receiver | Callback
<
[ThreeFingersSwipe](js-apis-multimodalinput-gestureevent.md#threefingersswipe)
>
| 否 | 需要取消监听的回调函数
。若不填
,则取消当前应用监听的所有回调函数。 |
**示例:**
**示例:**
...
@@ -374,7 +371,7 @@ try {
...
@@ -374,7 +371,7 @@ try {
on(type: 'fourFingersSwipe', receiver: Callback
<
[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)
>
): void
on(type: 'fourFingersSwipe', receiver: Callback
<
[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)
>
): void
监听全局
的触控板
四指滑动事件。
监听全局
触控板的
四指滑动事件。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -384,7 +381,7 @@ on(type: 'fourFingersSwipe', receiver: Callback<[FourFingersSwipe](js-apis-mu
...
@@ -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)
>
| 是 | 回调函数,异步上报四指滑动输入事件。 |
| receiver | Callback
<
[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)
>
| 是 | 回调函数,异步上报四指滑动输入事件。 |
**示例:**
**示例:**
...
@@ -404,7 +401,7 @@ try {
...
@@ -404,7 +401,7 @@ try {
off(type: 'fourFingersSwipe', receiver?: Callback
<
[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)
>
): void
off(type: 'fourFingersSwipe', receiver?: Callback
<
[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)
>
): void
取消监听全局
的触控板
四指滑动事件。
取消监听全局
触控板的
四指滑动事件。
**需要权限:**
ohos.permission.INPUT_MONITORING
**需要权限:**
ohos.permission.INPUT_MONITORING
...
@@ -414,8 +411,8 @@ off(type: 'fourFingersSwipe', receiver?: Callback<[FourFingersSwipe](js-apis-
...
@@ -414,8 +411,8 @@ off(type: 'fourFingersSwipe', receiver?: Callback<[FourFingersSwipe](js-apis-
| 参数名 | 类型 | 必填 | 说明 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | -------------------------- | ---- | ------------------- |
| -------- | -------------------------- | ---- | ------------------- |
| type | string | 是 | 输入设备事件类型,取值
“fourFingersSwipe”
。 |
| type | string | 是 | 输入设备事件类型,取值
'fourFingersSwipe'
。 |
| receiver | Callback
<
[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)
>
| 否 | 需要取消监听的回调函数
,若无此参数
,则取消当前应用监听的所有回调函数。 |
| receiver | Callback
<
[FourFingersSwipe](js-apis-multimodalinput-gestureevent.md#fourfingersswipe)
>
| 否 | 需要取消监听的回调函数
。若不填
,则取消当前应用监听的所有回调函数。 |
**示例:**
**示例:**
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录