diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/keyEvent.gif b/zh-cn/application-dev/reference/arkui-ts/figures/keyEvent.gif new file mode 100644 index 0000000000000000000000000000000000000000..27f4299b764f7bfda8e468ae987be57f43b701aa Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/keyEvent.gif differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/mouse.png b/zh-cn/application-dev/reference/arkui-ts/figures/mouse.png index 28baf4e713b69b4bea0e9ed3498a4a2ce12fc2b3..dd458d1940316dedd65d51542a78dc598cd61adf 100644 Binary files a/zh-cn/application-dev/reference/arkui-ts/figures/mouse.png and b/zh-cn/application-dev/reference/arkui-ts/figures/mouse.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/mouse1.png b/zh-cn/application-dev/reference/arkui-ts/figures/mouse1.png index dc3ea1fb958f1de66f6310e22b6163ebfbfb7494..aa6709fa32eb5c6a29eff6ea54588fc86e8240c6 100644 Binary files a/zh-cn/application-dev/reference/arkui-ts/figures/mouse1.png and b/zh-cn/application-dev/reference/arkui-ts/figures/mouse1.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001210353788.gif b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001210353788.gif index 38ffa5ca3c66dc3852f3a6045789473e8bdb0c41..f55a5e26c8b0dc0c11405b0b342399324afc3dbc 100644 Binary files a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001210353788.gif and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001210353788.gif differ diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md index 2e84bd5c8327546e79e4c4f3150931f3e2c8d857..1b0807c37495708b4748b0e1ef7376c591954613 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md @@ -19,13 +19,17 @@ | 名称 | 类型 | 描述 | | ------------------- | ------------------------------------ | -------------------------------------------------------- | -| screenX | number | 点击位置相对于应用窗口左上角的X坐标。 | -| screenY | number | 点击位置相对于应用窗口左上角的Y坐标。 | | x | number | 点击位置相对于被点击元素左上角的X坐标。 | | y | number | 点击位置相对于被点击元素左上角的Y坐标。 | | timestamp8+ | number | 事件时间戳。触发事件时距离系统启动的时间间隔，单位纳秒。 | | target8+ | [EventTarget](#eventtarget8对象说明) | 触发事件的元素对象显示区域。 | | source8+ | [SourceType](ts-gesture-settings.md#sourcetype枚举说明) | 事件输入设备。 | +| windowX10+ | number | 点击位置相对于应用窗口左上角的X坐标。 | +| windowY10+ | number | 点击位置相对于应用窗口左上角的Y坐标。 | +| displayX10+ | number | 点击位置相对于应用屏幕左上角的X坐标。 | +| displayY10+ | number | 点击位置相对于应用屏幕左上角的Y坐标。 | +| screenX(deprecated) | number | 点击位置相对于应用窗口左上角的X坐标。
从API verdion 10开始不再维护，建议使用windowX代替。 | +| screenY(deprecated) | number | 点击位置相对于应用窗口左上角的Y坐标。
从API verdion 10开始不再维护，建议使用windowY代替。 | ## EventTarget8+对象说明 @@ -51,14 +55,14 @@ struct ClickExample { Row({ space: 20 }) { Button('Click').width(100).height(40) .onClick((event: ClickEvent) => { - this.text = 'Click Point:' + '\n screenX:' + event.screenX + '\n screenY:' + event.screenY + this.text = 'Click Point:' + '\n windowX:' + event.windowX + '\n windowY:' + event.windowY + '\n x:' + event.x + '\n y:' + event.y + '\ntarget:' + '\n component globalPos:(' + event.target.area.globalPosition.x + ',' + event.target.area.globalPosition.y + ')\n width:' + event.target.area.width + '\n height:' + event.target.area.height + '\ntimestamp' + event.timestamp; }) Button('Click').width(200).height(50) .onClick((event: ClickEvent) => { - this.text = 'Click Point:' + '\n screenX:' + event.screenX + '\n screenY:' + event.screenY + this.text = 'Click Point:' + '\n windowX:' + event.windowX + '\n windowY:' + event.windowY + '\n x:' + event.x + '\n y:' + event.y + '\ntarget:' + '\n component globalPos:(' + event.target.area.globalPosition.x + ',' + event.target.area.globalPosition.y + ')\n width:' + event.target.area.width + '\n height:' + event.target.area.height + '\ntimestamp' + event.timestamp; diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md index 291aeb168e1a2a4d8b401084e78cf967b7cbe370..bcda96d1f0f386fcca498a3c86069c6812a9a0ca 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md @@ -44,24 +44,28 @@ | 名称 | 类型 | 描述 | | ------ | ------ | ---------------- | -| getX() | number | 当前拖拽点相对于屏幕左上角的x轴坐标，单位为vp。 | -| getY() | number | 当前拖拽点相对于屏幕左上角的y轴坐标，单位为vp。 | | useCustomDropAnimation10+ | boolean | 当拖拽结束时，是否使用系统默认落入动画。 | | setData(unifiedData: [UnifiedData](../apis/js-apis-data-udmf.md#unifieddata))10+ | void | 向DragEvent中设置拖拽相关数据。 | | getData()10+ | [UnifiedData](../apis/js-apis-data-udmf.md#unifieddata) | 从DragEvent中获取拖拽相关数据。 | | getSummary()10+ | [Summary](../apis/js-apis-data-udmf.md#summary) | 从DragEvent中获取拖拽相关数据的简介。 | -| setResult(dragRect: [DragRet](#dragret10枚举说明))10+ | void | 向DragEvent中设置拖拽结果。 | -| getResult()10+ | [DragRet](#dragret10枚举说明) | 从DragEvent中获取拖拽结果。 | +| setResult(dragRect: [DragResult](#dragresult10枚举说明))10+ | void | 向DragEvent中设置拖拽结果。 | +| getResult()10+ | [DragResult](#dragresult10枚举说明) | 从DragEvent中获取拖拽结果。 | | getPrviewRect()10+ | [Rectangle](ts-universal-attributes-touch-target.md#rectangle对象说明) | 获取预览图所在的Rectangle。 | | getVelocityX()10+ | number | 获取当前拖拽的x轴方向拖动速度。坐标轴原点为屏幕左上角，单位为vp，分正负方向速度，从左往右为正，反之为负。 | | getVelocityY()10+ | number | 获取当前拖拽的y轴方向拖动速度。坐标轴原点为屏幕左上角，单位为vp，分正负方向速度，从上往下为正，反之为负。 | | getVelocity()10+ | number | 获取当前拖拽的主方向拖动速度。为xy轴方向速度的平方和的算术平方根。 | +| getWindowX()10+ | number | 当前拖拽点相对于窗口左上角的x轴坐标，单位为vp。 | +| getWindowY()10+ | number | 当前拖拽点相对于窗口左上角的y轴坐标，单位为vp。 | +| getDisplayX()10+ | number | 当前拖拽点相对于屏幕左上角的x轴坐标，单位为vp。 | +| getDisplayY()10+ | number | 当前拖拽点相对于屏幕左上角的y轴坐标，单位为vp。 | +| getX()(deprecated) | number | 当前拖拽点相对于窗口左上角的x轴坐标，单位为vp。
从API verdion 10开始不再维护，建议使用getWindowX()代替。 | +| getY()(deprecated) | number | 当前拖拽点相对于窗口左上角的y轴坐标，单位为vp。
从API verdion 10开始不再维护，建议使用getWindowY()代替。 | -## DragRet10+枚举说明 +## DragResult10+枚举说明 | 名称 | 描述 | | ----- | ----------------- | -| DRAG_SUCCESS | 拖拽成功 | +| DRAG_SUCCESSFUL | 拖拽成功 | | DRAG_FAILED | 拖拽失败 | | DRAG_CANCELED | 拖拽取消 | | DROP_ENABLED | 组件允许落入 | @@ -126,9 +130,9 @@ struct Index { .margin({left: 15}) .visibility(this.imgState) .onDragEnd((event)=>{ - if (event.getResult() === DragRet.DRAG_SUCCESS) { + if (event.getResult() === DragResult.DRAG_SUCCESSFUL) { promptAction.showToast({duration: 100, message: 'Drag Success'}); - } else if (event.getResult() === DragRet.DRAG_FAILED) { + } else if (event.getResult() === DragResult.DRAG_FAILED) { promptAction.showToast({duration: 100, message: 'Drag failed'}); } }) @@ -199,7 +203,7 @@ struct Index { this.imageHeight = 100; this.imgState = Visibility.None; }) - event.setResult(DragRet.DRAG_SUCCESS); + event.setResult(DragResult.DRAG_SUCCESSFUL); }) }) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md index 9d5189505861443501e4bb079ae2526f5c3c3624..ed0cf84d3a07c191948e10dd5a34130ecd6dbcdd 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md @@ -27,6 +27,7 @@ | metaKey | number | 按键发生时元键（即Windows键盘的WIN键、Mac键盘的Command键）的状态，1表示按压态，0表示未按压态。 | | timestamp | number | 按键发生时的时间戳。 | | stopPropagation | () => void | 阻塞事件冒泡传递。 | +| intentionCode10+ | [IntentionCode](../apis/js-apis-intentioncode.md) | 按键对应的意图。 | ## 示例 @@ -49,7 +50,7 @@ struct KeyEventExample { if (event.type === KeyType.Up) { this.eventType = 'Up' } - this.text = 'KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText + this.text = 'KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText + '\nintentionCode:' + event.intentionCode }) Text(this.text).padding(15) }.height(300).width('100%').padding(35) @@ -57,4 +58,4 @@ struct KeyEventExample { } ``` - ![keyEvent](figures/keyEvent.png) + ![keyEvent](figures/keyEvent.gif) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md index 119a985af2195768d9cc81a8629239c178dcff2f..437d00b5c1b0fa41b0fc11bf0f63dad861d1f0a9 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md @@ -34,10 +34,14 @@ | ------- | ------------------------------------------- | ------------------------------------- | | type | [TouchType](ts-appendix-enums.md#touchtype) | 触摸事件的类型。 | | id | number | 手指唯一标识符。 | -| screenX | number | 触摸点相对于应用窗口左上角的X坐标。 | -| screenY | number | 触摸点相对于应用窗口左上角的Y坐标。 | | x | number | 触摸点相对于被触摸元素左上角的X坐标。 | | y | number | 触摸点相对于被触摸元素左上角的Y坐标。 | +| windowX10+ | number | 触摸点相对于应用窗口左上角的X坐标。 | +| windowY10+ | number | 触摸点相对于应用窗口左上角的Y坐标。 | +| displayX10+ | number | 触摸点相对于应用屏幕左上角的X坐标。 | +| displayY10+ | number | 触摸点相对于应用屏幕左上角的Y坐标。 | +| screenX(deprecated) | number | 触摸点相对于应用窗口左上角的X坐标。
从API verdion 10开始不再维护，建议使用windowX代替。 | +| screenY(deprecated) | number | 触摸点相对于应用窗口左上角的Y坐标。
从API verdion 10开始不再维护，建议使用windowX代替。 | ## HistoricalPoint10+对象说明 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md index f308cb69df725bfb4b8b03c2b90c1cdf5aecce6e..ae97b883ecb7c8fdeac1f5567586e4c18aa061ee 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md @@ -23,8 +23,6 @@ | 名称 | 属性类型 | 描述 | | ---------------------- | ---------------------------------------- | ---------------------------- | -| screenX | number | 鼠标位置相对于应用窗口左上角的x轴坐标。 | -| screenY | number | 鼠标位置相对于应用窗口左上角的y轴坐标。 | | x | number | 鼠标位置相对于当前组件左上角的x轴坐标。 | | y | number | 鼠标位置相对于当前组件左上角的y轴坐标。 | | button | [MouseButton](ts-appendix-enums.md#mousebutton) | 鼠标按键。 | @@ -33,6 +31,12 @@ | timestamp8+ | number | 事件时间戳。触发事件时距离系统启动的时间间隔，单位纳秒。 | | target8+ | [EventTarget](ts-universal-events-click.md#eventtarget8对象说明) | 触发事件的元素对象显示区域。 | | source8+ | [SourceType](ts-gesture-settings.md#sourcetype枚举说明) | 事件输入设备。 | +| windowX10+ | number | 鼠标位置相对于应用窗口左上角的x轴坐标。 | +| windowY10+ | number | 鼠标位置相对于应用窗口左上角的y轴坐标。 | +| displayX10+ | number | 鼠标位置相对于应用屏幕左上角的x轴坐标。 | +| displayY10+ | number | 鼠标位置相对于应用屏幕左上角的y轴坐标。 | +| screenX(deprecated) | number | 鼠标位置相对于应用窗口左上角的x轴坐标。
从API verdion 10开始不再维护，建议使用windowX代替。 | +| screenY(deprecated) | number | 鼠标位置相对于应用窗口左上角的y轴坐标。
从API verdion 10开始不再维护，建议使用windowY代替。 | ## HoverEvent10+对象说明 @@ -107,7 +111,7 @@ struct MouseEventExample { } this.mouseText = 'onMouse:\nButton = ' + this.mouseBtn + '\nAction = ' + this.action + '\nXY=(' + event.x + ',' + event.y + ')' + - '\nscreenXY=(' + event.screenX + ',' + event.screenY + ')'; + '\nwindowXY=(' + event.windowX + ',' + event.windowY + ')'; }) Text(this.mouseText) }.padding({ top: 30 }).width('100%') diff --git a/zh-cn/application-dev/ui/arkts-common-events-device-input-event.md b/zh-cn/application-dev/ui/arkts-common-events-device-input-event.md index ad0276b9766be22514f96d99b0fcbd6d14309f8f..603e30e199016366527acb6668f70b3faf53b3d7 100644 --- a/zh-cn/application-dev/ui/arkts-common-events-device-input-event.md +++ b/zh-cn/application-dev/ui/arkts-common-events-device-input-event.md @@ -102,7 +102,7 @@ onMouse(event: (event?: MouseEvent) => void) 鼠标事件回调。绑定该API的组件每当鼠标指针在该组件内产生行为（MouseAction）时，触发事件回调，参数为[MouseEvent](../reference/arkui-ts/ts-universal-mouse-key.md)对象，表示触发此次的鼠标事件。该事件支持自定义冒泡设置，默认父子冒泡。常见用于开发者自定义的鼠标行为逻辑处理。 -开发者可以通过回调中的MouseEvent对象获取触发事件的坐标（screenX/screenY/x/y）、按键（[MouseButton](../reference/arkui-ts/ts-appendix-enums.md#mousebutton)）、行为（[MouseAction](../reference/arkui-ts/ts-appendix-enums.md#mouseaction)）、时间戳（timestamp）、交互组件的区域（[EventTarget](../reference/arkui-ts/ts-universal-events-click.md)）、事件来源（[SourceType](../reference/arkui-ts/ts-gesture-settings.md)）等。MouseEvent的回调函数stopPropagation用于设置当前事件是否阻止冒泡。 +开发者可以通过回调中的MouseEvent对象获取触发事件的坐标（displayX/displayY/windowX/windowY/x/y）、按键（[MouseButton](../reference/arkui-ts/ts-appendix-enums.md#mousebutton)）、行为（[MouseAction](../reference/arkui-ts/ts-appendix-enums.md#mouseaction)）、时间戳（timestamp）、交互组件的区域（[EventTarget](../reference/arkui-ts/ts-universal-events-click.md)）、事件来源（[SourceType](../reference/arkui-ts/ts-gesture-settings.md)）等。MouseEvent的回调函数stopPropagation用于设置当前事件是否阻止冒泡。 >**说明：** @@ -134,7 +134,7 @@ struct MouseExample { 'button = ' + event.button + '\n' + 'action = ' + event.action + '\n' + 'x,y = (' + event.x + ',' + event.y + ')' + '\n' + - 'screenXY=(' + event.screenX + ',' + event.screenY + ')'; + 'windowXY=(' + event.windowX + ',' + event.windowY + ')'; }) Divider() Text(this.buttonText).fontColor(Color.Green) @@ -151,7 +151,7 @@ struct MouseExample { 'button = ' + event.button + '\n' + 'action = ' + event.action + '\n' + 'x,y = (' + event.x + ',' + event.y + ')' + '\n' + - 'screenXY=(' + event.screenX + ',' + event.screenY + ')'; + 'windowXY=(' + event.windowX + ',' + event.windowY + ')'; }) } } @@ -190,7 +190,7 @@ Button(this.isHovered ? 'Hovered!' : 'Not Hover') 'button = ' + event.button + '\n' + 'action = ' + event.action + '\n' + 'x,y = (' + event.x + ',' + event.y + ')' + '\n' + - 'screenXY=(' + event.screenX + ',' + event.screenY + ')'; + 'windowXY=(' + event.windowX + ',' + event.windowY + ')'; }) ``` diff --git a/zh-cn/application-dev/ui/figures/onMouse1.gif b/zh-cn/application-dev/ui/figures/onMouse1.gif index b92b55b094f1daf97cfd92d0192d24977e28d410..6784677e45c235fef08faec87e5e55e59097d036 100644 Binary files a/zh-cn/application-dev/ui/figures/onMouse1.gif and b/zh-cn/application-dev/ui/figures/onMouse1.gif differ