From 3f01753ca74db70bffd866f8ea80c10b96a17f3a Mon Sep 17 00:00:00 2001 From: shaoziyun Date: Mon, 30 May 2022 06:27:34 +0000 Subject: [PATCH] m11 Signed-off-by: shaoziyun --- .../reference/apis/js-apis-inputconsumer.md | 34 +- .../reference/apis/js-apis-inputevent.md | 24 ++ .../apis/js-apis-inputeventclient.md | 0 .../reference/apis/js-apis-inputkeycode.md | 351 ++++++++++++++++++ .../reference/apis/js-apis-inputkeyevent.md | 66 ++++ .../reference/apis/js-apis-inputmonitor.md | 6 +- .../reference/apis/js-apis-inputmouseevent.md | 120 ++++++ .../reference/apis/js-apis-inputtouchevent.md | 118 ++++++ 8 files changed, 699 insertions(+), 20 deletions(-) mode change 100644 => 100755 zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md create mode 100755 zh-cn/application-dev/reference/apis/js-apis-inputevent.md mode change 100644 => 100755 zh-cn/application-dev/reference/apis/js-apis-inputeventclient.md create mode 100755 zh-cn/application-dev/reference/apis/js-apis-inputkeycode.md create mode 100755 zh-cn/application-dev/reference/apis/js-apis-inputkeyevent.md create mode 100755 zh-cn/application-dev/reference/apis/js-apis-inputmouseevent.md create mode 100755 zh-cn/application-dev/reference/apis/js-apis-inputtouchevent.md diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md b/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md old mode 100644 new mode 100755 index 1c5c650644..c0c68148d5 --- a/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputconsumer.md @@ -18,9 +18,9 @@ import inputConsumer from '@ohos.multimodalInput.inputConsumer'; ## inputConsumer.on -on(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): void +on(type: "key", keyOptions: KeyOptions, callback: Callback): void -开始监听组合按键事件, 当满足条件的组合按键输入事件发生时，将KeyOption回调到入参callback表示的回调函数上。 +开始监听组合按键事件, 当满足条件的组合按键输入事件发生时，将keyOptions回调到入参callback表示的回调函数上。 **系统能力：** SystemCapability.MultimodalInput.Input.InputConsumer @@ -29,24 +29,24 @@ on(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): void | 参数 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 监听输入事件类型，只支持“key”。 | -| keyOption | [KeyOption](#keyoption) | 是 | 组合键选项，用来指定组合键输入时应该符合的条件。 | -| callback | Callback<KeyOption> | 是 | 回调函数。当满足条件的按键输入产生时，回调到此函数，以传入的keyOption为入参。 | +| keyOptions | [keyOptions](#keyOptions) | 是 | 组合键选项，用来指定组合键输入时应该符合的条件。 | +| callback | KeyOptions | 是 | 回调函数。当满足条件的按键输入产生时，回调到此函数，以传入的KeyOptions为入参。 | **示例：** ``` -let keyOption = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0} -let callback = function(keyOption) { - console.info("preKeys: " + keyOption.preKeys, "finalKey: " + keyOption.finalKey, - "isFinalKeyDown: " + keyOption.isFinalKeyDown, "finalKeyDownDuration: " + keyOption.finalKeyDownDuration) +let keyOptions = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0} +let callback = function(keyOptions) { + console.info("preKeys: " + keyOptions.preKeys, "finalKey: " + keyOptions.finalKey, + "isFinalKeyDown: " + keyOptions.isFinalKeyDown, "finalKeyDownDuration: " + keyOptions.finalKeyDownDuration) } -inputConsumer.on('key', keyOption, callback); +inputConsumer.on('key', keyOptions, callback); ``` ## inputConsumer.off -off(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): void +off(type: "key", keyOptions: KeyOptions, callback?: Callback): void 停止监听组合按键事件。 @@ -57,18 +57,18 @@ off(type: "key", keyOption: KeyOption, callback: Callback<KeyOption>): voi | 参数 | 类型 | 必填 | 说明 | | -------- | -------- | -------- | -------- | | type | string | 是 | 监听输入事件类型，只支持“key”。 | -| keyOption | [KeyOption](#keyoption) | 是 | 开始监听时传入的KeyOption。 | -| callback | Callback<KeyOption> | 是 | 开始监听时与KeyOption一同传入的回调函数 。 | +| keyOptions | [keyOptions](#keyOptions) | 是 | 开始监听时传入的keyOptions。 | +| callback | Callback | 是 | 开始监听时与KeyOption一同传入的回调函数 。 | **示例：** ``` -let keyOption = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0} -let callback = function(keyOption) { - console.info("preKeys: " + keyOption.preKeys, "finalKey: " + keyOption.finalKey, - "isFinalKeyDown: " + keyOption.isFinalKeyDown, "finalKeyDownDuration: " + keyOption.finalKeyDownDuration) +let keyOptions = {preKeys: [], finalKey: 3, isFinalKeyDown: true, finalKeyDownDuration: 0} +let callback = function(keyOptions) { + console.info("preKeys: " + keyOptions.preKeys, "finalKey: " + keyOptions.finalKey, + "isFinalKeyDown: " + keyOptions.isFinalKeyDown, "finalKeyDownDuration: " + keyOptions.finalKeyDownDuration) } -inputConsumer.off('key', keyOption, callback); +inputConsumer.off('key', keyOptions, callback); ``` diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputevent.md b/zh-cn/application-dev/reference/apis/js-apis-inputevent.md new file mode 100755 index 0000000000..e7ad2eba58 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-inputevent.md @@ -0,0 +1,24 @@ +# InputEvent + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + + +## 导入模块 + +```ts +import InputEvent from '@ohos.multimodalInput.inputEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| id | number | 是 | 否 | 由服务端生成全局唯一事件id | +| deviceId | number | 是 | 否 | 上报输入事件的设备id | +| actionTime | number | 是 | 否 | 事件发生时间 | +| screenId | number | 是 | 否 | 目标屏幕id | +| windowId | number | 是 | 否 | 目标窗口id | \ No newline at end of file diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputeventclient.md b/zh-cn/application-dev/reference/apis/js-apis-inputeventclient.md old mode 100644 new mode 100755 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputkeycode.md b/zh-cn/application-dev/reference/apis/js-apis-inputkeycode.md new file mode 100755 index 0000000000..520bdb7b14 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-inputkeycode.md @@ -0,0 +1,351 @@ +# KeyCode + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +## 导入模块 + +```ts +import {KeyCode} from '@ohos.multimodalInput.keyCode' +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| KEYCODE_FN | number | 是 | 否 | 功能（Fn）键 | +| KEYCODE_UNKNOWN | number | 是 | 否 | 未知按键 | +| KEYCODE_HOME | number | 是 | 否 | 按键Home | +| KEYCODE_BACK | number | 是 | 否 | 返回键 | +| KEYCODE_MEDIA_PLAY_PAUSE | number | 是 | 否 | 多媒体键 播放/暂停 | +| KEYCODE_MEDIA_STOP | number | 是 | 否 | 多媒体键 停止 | +| KEYCODE_MEDIA_NEXT | number | 是 | 否 | 多媒体键 下一首 | +| KEYCODE_MEDIA_PREVIOUS | number | 是 | 否 | 多媒体键 上一首 | +| KEYCODE_MEDIA_REWIND | number | 是 | 否 | 多媒体键 快退 | +| KEYCODE_MEDIA_FAST_FORWARD | number | 是 | 否 | 多媒体键 快进 | +| KEYCODE_VOLUME_UP | number | 是 | 否 | 音量增加键 | +| KEYCODE_VOLUME_DOWN | number | 是 | 否 | 音量减小键 | +| KEYCODE_POWER | number | 是 | 否 | 电源键 | +| KEYCODE_CAMERA | number | 是 | 否 | 拍照键 | +| KEYCODE_VOLUME_MUTE | number | 是 | 否 | 扬声器静音键 | +| KEYCODE_MUTE | number | 是 | 否 | 话筒静音键 | +| KEYCODE_BRIGHTNESS_UP | number | 是 | 否 | 亮度调节按键 调亮 | +| KEYCODE_BRIGHTNESS_DOWN | number | 是 | 否 | 亮度调节按键 调暗 | +| KEYCODE_0 | number | 是 | 否 | 按键'0' | +| KEYCODE_1 | number | 是 | 否 | 按键'1' | +| KEYCODE_2 | number | 是 | 否 | 按键'2' | +| KEYCODE_3 | number | 是 | 否 | 按键'3' | +| KEYCODE_4 | number | 是 | 否 | 按键'4' | +| KEYCODE_5 | number | 是 | 否 | 按键'5' | +| KEYCODE_6 | number | 是 | 否 | 按键'6' | +| KEYCODE_7 | number | 是 | 否 | 按键'7' | +| KEYCODE_8 | number | 是 | 否 | 按键'8' | +| KEYCODE_9 | number | 是 | 否 | 按键'9' | +| KEYCODE_STAR | number | 是 | 否 | 按键'*' | +| KEYCODE_POUND | number | 是 | 否 | 按键'#' | +| KEYCODE_DPAD_UP | number | 是 | 否 | 导航键 向上 | +| KEYCODE_DPAD_DOWN | number | 是 | 否 | 导航键 向下 | +| KEYCODE_DPAD_LEFT | number | 是 | 否 | 导航键 向左 | +| KEYCODE_DPAD_RIGHT | number | 是 | 否 | 导航键 向右 | +| KEYCODE_DPAD_CENTER | number | 是 | 否 | 导航键 确定键 | +| KEYCODE_A | number | 是 | 否 | 按键'A' | +| KEYCODE_B | number | 是 | 否 | 按键'B' | +| KEYCODE_C | number | 是 | 否 | 按键'C' | +| KEYCODE_D | number | 是 | 否 | 按键'D' | +| KEYCODE_E | number | 是 | 否 | 按键'E' | +| KEYCODE_F | number | 是 | 否 | 按键'F' | +| KEYCODE_G | number | 是 | 否 | 按键'G' | +| KEYCODE_H | number | 是 | 否 | 按键'H' | +| KEYCODE_I | number | 是 | 否 | 按键'I' | +| KEYCODE_J | number | 是 | 否 | 按键'J' | +| KEYCODE_K | number | 是 | 否 | 按键'K' | +| KEYCODE_L | number | 是 | 否 | 按键'L' | +| KEYCODE_M | number | 是 | 否 | 按键'M' | +| KEYCODE_N | number | 是 | 否 | 按键'N' | +| KEYCODE_O | number | 是 | 否 | 按键'O' | +| KEYCODE_P | number | 是 | 否 | 按键'P' | +| KEYCODE_Q | number | 是 | 否 | 按键'Q' | +| KEYCODE_R | number | 是 | 否 | 按键'R' | +| KEYCODE_S | number | 是 | 否 | 按键'S' | +| KEYCODE_T | number | 是 | 否 | 按键'T' | +| KEYCODE_U | number | 是 | 否 | 按键'U' | +| KEYCODE_V | number | 是 | 否 | 按键'V' | +| KEYCODE_W | number | 是 | 否 | 按键'W' | +| KEYCODE_X | number | 是 | 否 | 按键'X' | +| KEYCODE_Y | number | 是 | 否 | 按键'Y' | +| KEYCODE_Z | number | 是 | 否 | 按键'Z' | +| KEYCODE_COMMA | number | 是 | 否 | 按键',' | +| KEYCODE_PERIOD | number | 是 | 否 | 按键'.' | +| KEYCODE_ALT_LEFT | number | 是 | 否 | Alt+Left | +| KEYCODE_ALT_RIGHT | number | 是 | 否 | Alt+Right | +| KEYCODE_SHIFT_LEFT | number | 是 | 否 | Shift+Left | +| KEYCODE_SHIFT_RIGHT | number | 是 | 否 | Shift+Right | +| KEYCODE_TAB | number | 是 | 否 | Tab键 | +| KEYCODE_SPACE | number | 是 | 否 | 空格键 | +| KEYCODE_SYM | number | 是 | 否 | 符号修改器按键 | +| KEYCODE_EXPLORER | number | 是 | 否 | 浏览器功能键，此键用于启动浏览器应用程序。 | +| KEYCODE_ENVELOPE | number | 是 | 否 | 电子邮件功能键，此键用于启动电子邮件应用程序。| +| KEYCODE_ENTER | number | 是 | 否 | 回车键 | +| KEYCODE_DEL | number | 是 | 否 | 退格键 | +| KEYCODE_GRAVE | number | 是 | 否 | 按键'`' | +| KEYCODE_MINUS | number | 是 | 否 | 按键'-' | +| KEYCODE_EQUALS | number | 是 | 否 | 按键'=' | +| KEYCODE_LEFT_BRACKET | number | 是 | 否 | 按键'[' | +| KEYCODE_RIGHT_BRACKET | number | 是 | 否 | 按键']' | +| KEYCODE_BACKSLASH | number | 是 | 否 | 按键'\' | +| KEYCODE_SEMICOLON | number | 是 | 否 | 按键';' | +| KEYCODE_APOSTROPHE | number | 是 | 否 | 按键''' (单引号) | +| KEYCODE_SLASH | number | 是 | 否 | 按键'/' | +| KEYCODE_AT | number | 是 | 否 | 按键'@' | +| KEYCODE_PLUS | number | 是 | 否 | 按键'+' | +| KEYCODE_MENU | number | 是 | 否 | 菜单键 | +| KEYCODE_PAGE_UP | number | 是 | 否 | 向上翻页键 | +| KEYCODE_PAGE_DOWN | number | 是 | 否 | 向下翻页键 | +| KEYCODE_ESCAPE | number | 是 | 否 | ESC键 | +| KEYCODE_FORWARD_DEL | number | 是 | 否 | 删除键 | +| KEYCODE_CTRL_LEFT | number | 是 | 否 | Control+Left | +| KEYCODE_CTRL_RIGHT | number | 是 | 否 | Control+Right | +| KEYCODE_CAPS_LOCK | number | 是 | 否 | 大写锁定键 | +| KEYCODE_SCROLL_LOCK | number | 是 | 否 | 滚动锁定键 | +| KEYCODE_META_LEFT | number | 是 | 否 | 左元修改器键 | +| KEYCODE_META_RIGHT | number | 是 | 否 | 右元修改器键 | +| KEYCODE_FUNCTION | number | 是 | 否 | 函数修改器键 | +| KEYCODE_SYSRQ | number | 是 | 否 | 系统请求/打印屏幕键 | +| KEYCODE_BREAK | number | 是 | 否 | Break/Pause键 | +| KEYCODE_MOVE_HOME | number | 是 | 否 | 光标移动到开始键 | +| KEYCODE_MOVE_END | number | 是 | 否 | 光标移动到末尾键 | +| KEYCODE_INSERT | number | 是 | 否 | 插入键 | +| KEYCODE_FORWARD | number | 是 | 否 | 删除键 | +| KEYCODE_MEDIA_PLAY | number | 是 | 否 | 多媒体键 播放 | +| KEYCODE_MEDIA_PAUSE | number | 是 | 否 | 多媒体键 暂停 | +| KEYCODE_MEDIA_CLOSE | number | 是 | 否 | 多媒体键 关闭 | +| KEYCODE_MEDIA_EJECT | number | 是 | 否 | 多媒体键 弹出 | +| KEYCODE_MEDIA_RECORD | number | 是 | 否 | 多媒体键 录音 | +| KEYCODE_F1 | number | 是 | 否 | 按键'F1' | +| KEYCODE_F2 | number | 是 | 否 | 按键'F2' | +| KEYCODE_F3 | number | 是 | 否 | 按键'F3' | +| KEYCODE_F4 | number | 是 | 否 | 按键'F4' | +| KEYCODE_F5 | number | 是 | 否 | 按键'F5' | +| KEYCODE_F6 | number | 是 | 否 | 按键'F6' | +| KEYCODE_F7 | number | 是 | 否 | 按键'F7' | +| KEYCODE_F8 | number | 是 | 否 | 按键'F8' | +| KEYCODE_F9 | number | 是 | 否 | 按键'F9' | +| KEYCODE_F10 | number | 是 | 否 | 按键'F10' | +| KEYCODE_F11 | number | 是 | 否 | 按键'F11' | +| KEYCODE_F12 | number | 是 | 否 | 按键'F12' | +| KEYCODE_NUM_LOCK | number | 是 | 否 | 小键盘锁 | +| KEYCODE_NUMPAD_0 | number | 是 | 否 | 小键盘按键'0' | +| KEYCODE_NUMPAD_1 | number | 是 | 否 | 小键盘按键'1' | +| KEYCODE_NUMPAD_2 | number | 是 | 否 | 小键盘按键'2' | +| KEYCODE_NUMPAD_3 | number | 是 | 否 | 小键盘按键'3' | +| KEYCODE_NUMPAD_4 | number | 是 | 否 | 小键盘按键'4' | +| KEYCODE_NUMPAD_5 | number | 是 | 否 | 小键盘按键'5' | +| KEYCODE_NUMPAD_6 | number | 是 | 否 | 小键盘按键'6' | +| KEYCODE_NUMPAD_7 | number | 是 | 否 | 小键盘按键'7' | +| KEYCODE_NUMPAD_8 | number | 是 | 否 | 小键盘按键'8' | +| KEYCODE_NUMPAD_9 | number | 是 | 否 | 小键盘按键'9' | +| KEYCODE_NUMPAD_DIVIDE | number | 是 | 否 | 小键盘按键'/' | +| KEYCODE_NUMPAD_MULTIPLY | number | 是 | 否 | 小键盘按键'*' | +| KEYCODE_NUMPAD_SUBTRACT | number | 是 | 否 | 小键盘按键'-' | +| KEYCODE_NUMPAD_ADD | number | 是 | 否 | 小键盘按键'+' | +| KEYCODE_NUMPAD_DOT | number | 是 | 否 | 小键盘按键'.' | +| KEYCODE_NUMPAD_COMMA | number | 是 | 否 | 小键盘按键',' | +| KEYCODE_NUMPAD_ENTER | number | 是 | 否 | 小键盘按键回车 | +| KEYCODE_NUMPAD_EQUALS | number | 是 | 否 | 小键盘按键'=' | +| KEYCODE_NUMPAD_LEFT_PAREN | number | 是 | 否 | 小键盘按键'(' | +| KEYCODE_NUMPAD_RIGHT_PAREN | number | 是 | 否 | 小键盘按键')' | +| KEYCODE_VIRTUAL_MULTITASK | number | 是 | 否 | 虚拟多任务键 | +| KEYCODE_SLEEP | number | 是 | 否 | 睡眠键 | +| KEYCODE_ZENKAKU_HANKAKU | number | 是 | 否 | 日文全宽/半宽键 | +| KEYCODE_102ND | number | 是 | 否 | 102nd按键 | +| KEYCODE_RO | number | 是 | 否 | 日文Ro键 | +| KEYCODE_KATAKANA | number | 是 | 否 | 日文片假名键 | +| KEYCODE_HIRAGANA | number | 是 | 否 | 日文平假名键 | +| KEYCODE_HENKAN | number | 是 | 否 | 日文转换键 | +| KEYCODE_KATAKANA_HIRAGANA | number | 是 | 否 | 日语片假名/平假名键 | +| KEYCODE_MUHENKAN | number | 是 | 否 | 日文非转换键 | +| KEYCODE_LINEFEED | number | 是 | 否 | 换行键 | +| KEYCODE_MACRO | number | 是 | 否 | 宏键 | +| KEYCODE_NUMPAD_PLUSMINUS | number | 是 | 否 | 数字键盘上的加号/减号键 | +| KEYCODE_SCALE | number | 是 | 否 | 扩展键 | +| KEYCODE_HANGUEL | number | 是 | 否 | 日文韩语键 | +| KEYCODE_HANJA | number | 是 | 否 | 日文汉语键 | +| KEYCODE_YEN | number | 是 | 否 | 日元键 | +| KEYCODE_STOP | number | 是 | 否 | 停止键 | +| KEYCODE_AGAIN | number | 是 | 否 | 重复键 | +| KEYCODE_PROPS | number | 是 | 否 | 道具键 | +| KEYCODE_UNDO | number | 是 | 否 | 撤消键 | +| KEYCODE_COPY | number | 是 | 否 | 复制键 | +| KEYCODE_OPEN | number | 是 | 否 | 打开键 | +| KEYCODE_PASTE | number | 是 | 否 | 粘贴键 | +| KEYCODE_FIND | number | 是 | 否 | 查找键 | +| KEYCODE_CUT | number | 是 | 否 | 剪切键 | +| KEYCODE_HELP | number | 是 | 否 | 帮助键 | +| KEYCODE_CALC | number | 是 | 否 | 计算器特殊功能键，用于启动计算器应用程序 | +| KEYCODE_FILE | number | 是 | 否 | 文件按键 | +| KEYCODE_BOOKMARKS | number | 是 | 否 | 书签键 | +| KEYCODE_NEXT | number | 是 | 否 | 下一个按键 | +| KEYCODE_PLAYPAUSE | number | 是 | 否 | 播放/暂停键 | +| KEYCODE_PREVIOUS | number | 是 | 否 | 上一个按键 | +| KEYCODE_STOPCD | number | 是 | 否 | CD停止键 | +| KEYCODE_CONFIG | number | 是 | 否 | 配置键 | +| KEYCODE_REFRESH | number | 是 | 否 | 刷新键 | +| KEYCODE_EXIT | number | 是 | 否 | 退出键 | +| KEYCODE_EDIT | number | 是 | 否 | 编辑键 | +| KEYCODE_SCROLLUP | number | 是 | 否 | 向上滚动键 | +| KEYCODE_SCROLLDOWN | number | 是 | 否 | 向下滚动键 | +| KEYCODE_NEW | number | 是 | 否 | 新建键 | +| KEYCODE_REDO | number | 是 | 否 | 恢复键 | +| KEYCODE_CLOSE | number | 是 | 否 | 关闭键 | +| KEYCODE_PLAY | number | 是 | 否 | 播放键 | +| KEYCODE_BASSBOOST | number | 是 | 否 | 低音增强键 | +| KEYCODE_PRINT | number | 是 | 否 | 打印键 | +| KEYCODE_CHAT | number | 是 | 否 | 聊天键 | +| KEYCODE_FINANCE | number | 是 | 否 | 金融键 | +| KEYCODE_CANCEL | number | 是 | 否 | 取消键 | +| KEYCODE_KBDILLUM_TOGGLE | number | 是 | 否 | 键盘灯光切换键 | +| KEYCODE_KBDILLUM_DOWN | number | 是 | 否 | 键盘灯光调亮键 | +| KEYCODE_KBDILLUM_UP | number | 是 | 否 | 键盘灯光调暗键 | +| KEYCODE_SEND | number | 是 | 否 | 发送键 | +| KEYCODE_REPLY | number | 是 | 否 | 答复键 | +| KEYCODE_FORWARDMAIL | number | 是 | 否 | 邮件转发键 | +| KEYCODE_SAVE | number | 是 | 否 | 保存键 | +| KEYCODE_DOCUMENTS | number | 是 | 否 | 文件键 | +| KEYCODE_VIDEO_NEXT | number | 是 | 否 | 下一个视频键 | +| KEYCODE_VIDEO_PREV | number | 是 | 否 | 上一个视频键 | +| KEYCODE_BRIGHTNESS_CYCLE | number | 是 | 否 | 背光渐变键 | +| KEYCODE_BRIGHTNESS_ZERO | number | 是 | 否 | 亮度调节为0键 | +| KEYCODE_DISPLAY_OFF | number | 是 | 否 | 显示关闭键 | +| KEYCODE_BTN_MISC | number | 是 | 否 | 游戏手柄上的各种按键 | +| KEYCODE_GOTO | number | 是 | 否 | 进入键 | +| KEYCODE_INFO | number | 是 | 否 | 信息查看键 | +| KEYCODE_PROGRAM | number | 是 | 否 | 程序键 | +| KEYCODE_PVR | number | 是 | 否 | 个人录像机(PVR)键 | +| KEYCODE_SUBTITLE | number | 是 | 否 | 字幕键 | +| KEYCODE_FULL_SCREEN | number | 是 | 否 | 全屏键 | +| KEYCODE_KEYBOARD | number | 是 | 否 | 键盘 | +| KEYCODE_ASPECT_RATIO | number | 是 | 否 | 屏幕纵横比调节键 | +| KEYCODE_PC | number | 是 | 否 | 端口控制键 | +| KEYCODE_TV | number | 是 | 否 | TV键 | +| KEYCODE_TV2 | number | 是 | 否 | TV键2 | +| KEYCODE_VCR | number | 是 | 否 | 录像机开启键 | +| KEYCODE_VCR2 | number | 是 | 否 | 录像机开启键2 | +| KEYCODE_SAT | number | 是 | 否 | SIM卡应用工具包（SAT）键 | +| KEYCODE_CD | number | 是 | 否 | CD键 | +| KEYCODE_TAPE | number | 是 | 否 | 磁带键 | +| KEYCODE_TUNER | number | 是 | 否 | 调谐器键 | +| KEYCODE_PLAYER | number | 是 | 否 | 播放器键 | +| KEYCODE_DVD | number | 是 | 否 | DVD键 | +| KEYCODE_AUDIO | number | 是 | 否 | 音频键 | +| KEYCODE_VIDEO | number | 是 | 否 | 视频键 | +| KEYCODE_MEMO | number | 是 | 否 | 备忘录键 | +| KEYCODE_CALENDAR | number | 是 | 否 | 日历键 | +| KEYCODE_RED | number | 是 | 否 | 红色指示器 | +| KEYCODE_GREEN | number | 是 | 否 | 绿色指示器 | +| KEYCODE_YELLOW | number | 是 | 否 | 黄色指示器 | +| KEYCODE_BLUE | number | 是 | 否 | 蓝色指示器 | +| KEYCODE_CHANNELUP | number | 是 | 否 | 频道向上键 | +| KEYCODE_CHANNELDOWN | number | 是 | 否 | 频道向下键 | +| KEYCODE_LAST | number | 是 | 否 | 末尾键 | +| KEYCODE_RESTART | number | 是 | 否 | 重启键 | +| KEYCODE_SLOW | number | 是 | 否 | 慢速键 | +| KEYCODE_SHUFFLE | number | 是 | 否 | 随机播放键 | +| KEYCODE_VIDEOPHONE | number | 是 | 否 | 可视电话键 | +| KEYCODE_GAMES | number | 是 | 否 | 游戏键 | +| KEYCODE_ZOOMIN | number | 是 | 否 | 放大键 | +| KEYCODE_ZOOMOUT | number | 是 | 否 | 缩小键 | +| KEYCODE_ZOOMRESET | number | 是 | 否 | 缩放重置键 | +| KEYCODE_WORDPROCESSOR | number | 是 | 否 | 文字处理键 | +| KEYCODE_EDITOR | number | 是 | 否 | 编辑器键 | +| KEYCODE_SPREADSHEET | number | 是 | 否 | 电子表格键 | +| KEYCODE_GRAPHICSEDITOR | number | 是 | 否 | 图形编辑器键 | +| KEYCODE_PRESENTATION | number | 是 | 否 | 演示文稿键 | +| KEYCODE_DATABASE | number | 是 | 否 | 数据库键标 | +| KEYCODE_NEWS | number | 是 | 否 | 新闻键 | +| KEYCODE_VOICEMAIL | number | 是 | 否 | 语音信箱 | +| KEYCODE_ADDRESSBOOK | number | 是 | 否 | 通讯簿 | +| KEYCODE_MESSENGER | number | 是 | 否 | 通信键 | +| KEYCODE_BRIGHTNESS_TOGGLE | number | 是 | 否 | 亮度切换键 | +| KEYCODE_SPELLCHECK | number | 是 | 否 | AL拼写检查 | +| KEYCODE_COFFEE | number | 是 | 否 | 终端锁/屏幕保护程序 | +| KEYCODE_MEDIA_REPEAT | number | 是 | 否 | 媒体循环键 | +| KEYCODE_IMAGES | number | 是 | 否 | 图像键 | +| KEYCODE_BUTTONCONFIG | number | 是 | 否 | 按键配置键 | +| KEYCODE_TASKMANAGER | number | 是 | 否 | 任务管理器 | +| KEYCODE_JOURNAL | number | 是 | 否 | 日志按键 | +| KEYCODE_CONTROLPANEL | number | 是 | 否 | 控制面板键 | +| KEYCODE_APPSELECT | number | 是 | 否 | 应用程序选择键 | +| KEYCODE_SCREENSAVER | number | 是 | 否 | 屏幕保护程序键 | +| KEYCODE_ASSISTANT | number | 是 | 否 | 辅助键 | +| KEYCODE_KBD_LAYOUT_NEXT | number | 是 | 否 | 下一个键盘布局键 | +| KEYCODE_BRIGHTNESS_MIN | number | 是 | 否 | 最小亮度键 | +| KEYCODE_BRIGHTNESS_MAX | number | 是 | 否 | 最大亮度键 | +| KEYCODE_KBDINPUTASSIST_PREV | number | 是 | 否 | 键盘输入Assist_Previous | +| KEYCODE_KBDINPUTASSIST_NEXT | number | 是 | 否 | 键盘输入Assist_Next | +| KEYCODE_KBDINPUTASSIST_PREVGROUP | number | 是 | 否 | 键盘输入Assist_Previous | +| KEYCODE_KBDINPUTASSIST_NEXTGROUP | number | 是 | 否 | 键盘输入Assist_Next | +| KEYCODE_KBDINPUTASSIST_ACCEPT | number | 是 | 否 | 键盘输入Assist_Accept | +| KEYCODE_KBDINPUTASSIST_CANCEL | number | 是 | 否 | 键盘输入Assist_Cancel | +| KEYCODE_FRONT | number | 是 | 否 | 挡风玻璃除雾器开关 | +| KEYCODE_SETUP | number | 是 | 否 | 设置键 | +| KEYCODE_WAKEUP | number | 是 | 否 | 唤醒键 | +| KEYCODE_SENDFILE | number | 是 | 否 | 发送文件按键 | +| KEYCODE_DELETEFILE | number | 是 | 否 | 删除文件按键 | +| KEYCODE_XFER | number | 是 | 否 | 文件传输(XFER)按键 | +| KEYCODE_PROG1 | number | 是 | 否 | 程序键1 | +| KEYCODE_PROG2 | number | 是 | 否 | 程序键2 | +| KEYCODE_MSDOS | number | 是 | 否 | MS-DOS键（微软磁盘操作系统 | +| KEYCODE_SCREENLOCK | number | 是 | 否 | 屏幕锁定键 | +| KEYCODE_DIRECTION_ROTATE_DISPLAY | number | 是 | 否 | 方向旋转显示键 | +| KEYCODE_CYCLEWINDOWS | number | 是 | 否 | Windows循环键 | +| KEYCODE_COMPUTER | number | 是 | 否 | 计算机按键 | +| KEYCODE_EJECTCLOSECD | number | 是 | 否 | 弹出CD键 | +| KEYCODE_ISO | number | 是 | 否 | ISO键 | +| KEYCODE_MOVE | number | 是 | 否 | 移动键 | +| KEYCODE_F13 | number | 是 | 否 | 按键'F13' | +| KEYCODE_F14 | number | 是 | 否 | 按键'F14' | +| KEYCODE_F15 | number | 是 | 否 | 按键'F15' | +| KEYCODE_F16 | number | 是 | 否 | 按键'F16' | +| KEYCODE_F17 | number | 是 | 否 | 按键'F17' | +| KEYCODE_F18 | number | 是 | 否 | 按键'F18' | +| KEYCODE_F19 | number | 是 | 否 | 按键'F19' | +| KEYCODE_F20 | number | 是 | 否 | 按键'F20' | +| KEYCODE_F21 | number | 是 | 否 | 按键'F21' | +| KEYCODE_F22 | number | 是 | 否 | 按键'F22' | +| KEYCODE_F23 | number | 是 | 否 | 按键'F23' | +| KEYCODE_F24 | number | 是 | 否 | 按键'F24' | +| KEYCODE_PROG3 | number | 是 | 否 | 程序键3 | +| KEYCODE_PROG4 | number | 是 | 否 | 程序键4 | +| KEYCODE_DASHBOARD | number | 是 | 否 | 仪表板 | +| KEYCODE_SUSPEND | number | 是 | 否 | 挂起键 | +| KEYCODE_HP | number | 是 | 否 | 高阶路径键 | +| KEYCODE_SOUND | number | 是 | 否 | 音量键 | +| KEYCODE_QUESTION | number | 是 | 否 | 疑问按键 | +| KEYCODE_CONNECT | number | 是 | 否 | 连接键 | +| KEYCODE_SPORT | number | 是 | 否 | 运动按键 | +| KEYCODE_SHOP | number | 是 | 否 | 商城键 | +| KEYCODE_ALTERASE | number | 是 | 否 | 交替键 | +| KEYCODE_SWITCHVIDEOMODE | number | 是 | 在可用视频之间循环输出（监视器/LCD/TV输出/等）| +| KEYCODE_BATTERY | number | 是 | 否 | 电池按键 | +| KEYCODE_BLUETOOTH | number | 是 | 否 | 蓝牙按键 | +| KEYCODE_WLAN | number | 是 | 否 | 无线局域网 | +| KEYCODE_UWB | number | 是 | 否 | 超宽带（UWB）| +| KEYCODE_WWAN_WIMAX | number | 是 | 否 | WWAN WiMAX按键 | +| KEYCODE_RFKILL | number | 是 | 否 | 控制所有收音机的键 | +| KEYCODE_CHANNEL | number | 是 | 否 | 向上频道键 | +| KEYCODE_BTN_0 | number | 是 | 否 | 按键0 | +| KEYCODE_BTN_1 | number | 是 | 否 | 按键1 | +| KEYCODE_BTN_2 | number | 是 | 否 | 按键2 | +| KEYCODE_BTN_3 | number | 是 | 否 | 按键3 | +| KEYCODE_BTN_4 | number | 是 | 否 | 按键4 | +| KEYCODE_BTN_5 | number | 是 | 否 | 按键5 | +| KEYCODE_BTN_6 | number | 是 | 否 | 按键6 | +| KEYCODE_BTN_7 | number | 是 | 否 | 按键7 | +| KEYCODE_BTN_8 | number | 是 | 否 | 按键8 | +| KEYCODE_BTN_9 | number | 是 | 否 | 按键9 | + + + + diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputkeyevent.md b/zh-cn/application-dev/reference/apis/js-apis-inputkeyevent.md new file mode 100755 index 0000000000..81ca673e5d --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-inputkeyevent.md @@ -0,0 +1,66 @@ +# Action + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +## 导入模块 + +```ts +import {Action} from '@ohos.multimodalInput.keyEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| CANCEL | number | 是 | 否 | 取消 | +| DOWN | number | 是 | 否 | 按钮按下 | +| UP | number | 是 | 否 | 按钮抬起 | + + +# Key + +## 导入模块 + +```ts +import {Key} from '@ohos.multimodalInput.mouseEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| code | KeyCode | 是 | 否 | 按键码 | +| pressedTime | number | 是 | 否 | 按下时间 | +| deviceId | number | 是 | 否 | 按键所属设备 | + +# KeyEvent + +## 导入模块 + +```ts +import {KeyEvent} from '@ohos.multimodalInput.mouseEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| action | Action | 是 | 否 | 按键动作 | +| key | Key | 是 | 否 | 当前发生变化的按键 | +| unicodeChar | number | 是 | 否 | 按键对应的uniCode字符 | +| keys | Key[] | 是 | 否 | 当前处于按下状态的按键列表 | +| ctrlKey | boolean | 是 | 否 | 当前ctrlKey是否处于按下状态 | +| altKey | boolean | 是 | 否 | 当前altKey是否处于按下状态 | +| shiftKey | boolean | 是 | 否 | 当前shiftKey是否处于按下状态 | +| logoKey | boolean | 是 | 否 | 当前logoKey是否处于按下状态 | +| fnKey | boolean | 是 | 否 | 当前fnKey是否处于按下状态 | +| capsLock | boolean | 是 | 否 | 当前capsLock是否处于激活状态 | +| numLock | boolean | 是 | 否 | 当前numLock是否处于激活状态 | +| scrollLock | boolean | 是 | 否 | 当前scrollLock是否处于激活状态 | \ No newline at end of file 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 4088e77cc6..eafc2f80d3 100755 --- a/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmonitor.md @@ -45,7 +45,7 @@ inputMonitor.off("touch", (event) => { }); ``` -on(type: "mouse", receiver: TouchEventReceiver): void +on(type: "mouse", receiver:Callback):void 开始监听全局鼠标事件。 @@ -72,7 +72,7 @@ inputMonitor.off("mouse", (event) => { ## inputMonitor.off -off(type: "touch", receiver: TouchEventReceiver): void +off(type: "touch", receiver?:TouchEventReceiver):void 开始监听全局触屏事件。 @@ -92,7 +92,7 @@ off(type: "touch", receiver: TouchEventReceiver): void inputMonitor.off("touch"); ``` -off(type: "mouse", receiver?: Callback): void +off(type: "mouse", receiver?:Callback):void 停止监听全局鼠标事件。 diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputmouseevent.md b/zh-cn/application-dev/reference/apis/js-apis-inputmouseevent.md new file mode 100755 index 0000000000..8c5c5bf824 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-inputmouseevent.md @@ -0,0 +1,120 @@ +# Action + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +## 导入模块 + +```ts +import {Action} from '@ohos.multimodalInput.mouseEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| CANCEL | number | 是 | 否 | 取消 | +| MOVE | number | 是 | 否 | 鼠标移动 | +| BUTTON_DOWN | number | 是 | 否 | 鼠标按钮按下 | +| BUTTON_UP | number | 是 | 否 | 鼠标按钮抬起 | +| AXIS_BEGIN | number | 是 | 否 | 鼠标关联的轴事件开始 | +| AXIS_UPDATE | number | 是 | 否 | 鼠标关联的轴事件更新 | +| AXIS_END | number | 是 | 否 | 鼠标关联的轴事件结束 | + + +# Button + +## 导入模块 + +```ts +import {Button} from '@ohos.multimodalInput.mouseEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| LEFT | number | 是 | 否 | 鼠标左键 | +| MIDDLE | number | 是 | 否 | 鼠标中键 | +| RIGHT | number | 是 | 否 | 鼠标右键 | +| SIDE | number | 是 | 否 | 鼠标侧边键 | +| EXTRA | number | 是 | 否 | 鼠标扩展键 | +| FORWARD | number | 是 | 否 | 鼠标前进键 | +| BACK | number | 是 | 否 | 鼠标后退键 | +| TASK | number | 是 | 否 | 鼠标任务键 | + + +# Axis + +## 导入模块 + +```ts +import {Axis} from '@ohos.multimodalInput.mouseEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| SCROLL_VERTICAL | number | 是 | 否 | 垂直滚动轴 | +| SCROLL_HORIZONTAL | number | 是 | 否 | 水平滚动轴 | +| PINCH | number | 是 | 否 | 捏合轴 | + + +# AxisValue + +## 导入模块 + +```ts +import {AxisValue} from '@ohos.multimodalInput.mouseEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| axis | Axis | 是 | 否 | 轴类型 | +| value | number | 是 | 否 | 轴的值 | + + +# MouseEvent + +## 导入模块 + +```ts +import {MouseEvent} from '@ohos.multimodalInput.mouseEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| action | Action | 是 | 否 | 鼠标事件动作 | +| screenX | number | 是 | 否 | 鼠标光标在屏幕中的x坐标 | +| screenY | number | 是 | 否 | 鼠标光标在屏幕中的y坐标 | +| windowX | number | 是 | 否 | 鼠标归属窗口的x坐标 | +| windowY | number | 是 | 否 | 鼠标归属窗口的y坐标 | +| rawDeltaX | number | 是 | 否 | X轴相对上次上报鼠标位置的偏移，在屏幕边缘位置时，该值可能小于两次鼠标上报的坐标差 | +| rawDeltaY | number | 是 | 否 | Y轴相对上次上报鼠标位置的偏移 | +| button | Button | 是 | 否 | 当前按下/抬起的按钮 | +| pressedButtons | Button[] | 是 | 否 | 当前处于按下状态的按钮 | +| axes | AxisValue[] | 是 | 否 | 事件包含的所有轴数据 | +| pressedKeys | KeyCode[] | 是 | 否 | 当前处于按下状态的按键列表 | +| ctrlKey | boolean | 是 | 否 | 当前ctrlKey是否处于按下状态 | +| altKey | boolean | 是 | 否 | 当前altKey是否处于按下状态 | +| shiftKey | boolean | 是 | 否 | 当前shiftKey是否处于按下状态 | +| logoKey | boolean | 是 | 否 | 当前logoKey是否处于按下状态 | +| fnKey | boolean | 是 | 否 | 当前fnKey是否处于按下状态 | +| capsLock | boolean | 是 | 否 | 当前capsLock是否处于激活状态 | +| numLock | boolean | 是 | 否 | 当前numLock是否处于激活状态 | +| scrollLock | boolean | 是 | 否 | 当前scrollLock是否处于激活状态 | diff --git a/zh-cn/application-dev/reference/apis/js-apis-inputtouchevent.md b/zh-cn/application-dev/reference/apis/js-apis-inputtouchevent.md new file mode 100755 index 0000000000..54f242b684 --- /dev/null +++ b/zh-cn/application-dev/reference/apis/js-apis-inputtouchevent.md @@ -0,0 +1,118 @@ +# Action + +> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** +> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 + +## 导入模块 + +```ts +import {Action} from '@ohos.multimodalInput.ToucEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| CANCEL | number | 是 | 否 | 触摸取消 | +| DOWN | number | 是 | 否 | 触摸按下 | +| MOVE | number | 是 | 否 | 触摸移动 | +| UP | number | 是 | 否 | 触摸抬起 | + + +# ToolType + +## 导入模块 + +```ts +import {ToolType} from '@ohos.multimodalInput.ToucEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| FINGER | number | 是 | 否 | 手指 | +| PEN | number | 是 | 否 | 笔 | +| RUBBER | number | 是 | 否 | 橡皮擦 | +| BRUSH | number | 是 | 否 | 笔刷 | +| PENCIL | number | 是 | 否 | 铅笔 | +| AIRBRUSH | number | 是 | 否 | 气笔 | +| MOUSE | number | 是 | 否 | 鼠标 | +| LENS | number | 是 | 否 | 透镜 | + + +# SourceType + +## 导入模块 + +```ts +import {SourceType} from '@ohos.multimodalInput.ToucEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| TOUCH_SCREEN | number | 是 | 否 | 触摸屏 | +| PEN | number | 是 | 否 | 手写笔 | +| TOUCH_PAD | number | 是 | 否 | 触摸板 | + + +# Touch + +## 导入模块 + +```ts +import {Touch} from '@ohos.multimodalInput.ToucEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| id | number | 是 | 否 | 指针标识 | +| pressedTime | number | 是 | 否 | 按下时的时间戳 | +| screenX | number | 是 | 否 | 触摸位置所属的屏幕x坐标 | +| screenY | number | 是 | 否 | 触摸位置所属的屏幕y坐标 | +| windowX | number | 是 | 否 | 触摸位置在窗口中的x坐标 | +| windowY | number | 是 | 否 | 触摸位置在窗口中的y坐标 | +| pressure | number | 是 | 否 | 压力值，取值范围是[0.0, 1.0], 0.0表示不支持 | +| width | number | 是 | 否 | 按下接触区域的宽度 | +| height | number | 是 | 否 | 按下接触区域的高度 | +| tiltX | number | 是 | 否 | 相对YZ平面的角度,取值的范围[-90, 90]，其中正值是向右倾斜。 | +| tiltY | number | 是 | 否 | 相对XZ平面的角度,值的范围[-90, 90]，其中正值是向下倾斜。 | +| toolX | number | 是 | 否 | 工具区域的中心点X | +| toolY | number | 是 | 否 | 工具区域的中心点Y | +| toolWidth | number | 是 | 否 | 工具区域宽度 | +| toolHeight | number | 是 | 否 | 工具区域高度 | +| rawX | number | 是 | 否 | 输入设备上的x坐标 | +| rawY | number | 是 | 否 | 输入设备上的y坐标 | +| toolType | number | 是 | 否 | 工具类型 | + + +# TouchEvent + +## 导入模块 + +```ts +import {TouchEvent} from '@ohos.multimodalInput.ToucEvent'; +``` + +## 属性 + +**系统能力**：以下各项对应的系统能力均为SystemCapability.MultimodalInput.Input.Core + +| 名称 | 参数类型 | 可读 | 可写 | 描述 | +| -------- | -------- | -------- | -------- | -------- | +| action | Action | 是 | 否 | 触摸动作 | +| touch | Touch | 是 | 否 | 当前触摸点 | +| touches | Touch[] | 是 | 否 | 所有触摸点 | +| sourceType | SourceType | 是 | 否 | 触摸来源的设备类型 | -- GitLab