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 1774141cf6cb4e24ede56c1ef4c87d64565e47b7..a9309ac3e26c482aecda550352b57fde64676a1b 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 @@ -55,7 +55,7 @@ ArkUI组件默认支持拖拽。 | ------ | ------ | ---------------- | | useCustomDropAnimation10+ | boolean | 当拖拽结束时,是否使用系统默认落入动画。 | | setData(unifiedData: [UnifiedData](../apis/js-apis-data-unifiedDataChannel.md#unifieddata))10+ | void | 向DragEvent中设置拖拽相关数据。 | -| getData()10+ | [UnifiedData](../apis/js-apis-data-unifiedDataChannel.md#unifieddata) | 从DragEvent中获取拖拽相关数据。 | +| getData()10+ | [UnifiedData](../apis/js-apis-data-unifiedDataChannel.md#unifieddata) | 从DragEvent中获取拖拽相关数据。数据获取结果请参考错误码说明。 | | getSummary()10+ | [Summary](../apis/js-apis-data-unifiedDataChannel.md#summary) | 从DragEvent中获取拖拽相关数据的简介。 | | setResult(dragRect: [DragResult](#dragresult10枚举说明))10+ | void | 向DragEvent中设置拖拽结果。 | | getResult()10+ | [DragResult](#dragresult10枚举说明) | 从DragEvent中获取拖拽结果。 | @@ -70,6 +70,15 @@ ArkUI组件默认支持拖拽。 | getX()(deprecated) | number | 当前拖拽点相对于窗口左上角的x轴坐标,单位为vp。
从API verdion 10开始不再维护,建议使用getWindowX()代替。 | | getY()(deprecated) | number | 当前拖拽点相对于窗口左上角的y轴坐标,单位为vp。
从API verdion 10开始不再维护,建议使用getWindowY()代替。 | +**错误码:** + +以下错误码的详细介绍请参见[drag-event(拖拽事件)](../errorcodes/errorcode-drag-event.md)错误码。 + +| 错误码ID | 错误信息 | +| --------- | ------- | +| 190001 | GetData failed, data not found. | +| 190002 | GetData failed, data error. | + ## DragResult10+枚举说明 | 名称 | 描述 | @@ -100,16 +109,21 @@ struct Index { getDataFromUdmfRetry(event: DragEvent, callback: (data: DragEvent)=>void) { - let data = event.getData(); - if (!data) { - return false; - } - let records: Array = data.getRecords(); - if (!records || records.length <= 0) { + try { + let data = event.getData(); + if (!data) { + return false; + } + let records: Array = data.getRecords(); + if (!records || records.length <= 0) { + return false; + } + callback(event); + return true; + } catch (e) { + console.log("getData failed, code = " + e.code + ", message = " + e.message); return false; } - callback(event); - return true; } getDataFromUdmf(event: DragEvent, callback: (data: DragEvent)=>void) diff --git a/zh-cn/application-dev/reference/errorcodes/Readme-CN.md b/zh-cn/application-dev/reference/errorcodes/Readme-CN.md index c176be6d1deae4f8930f9f7b741d2707e8967a01..5b4332201142200ab3d3de57c0300979ee061418 100644 --- a/zh-cn/application-dev/reference/errorcodes/Readme-CN.md +++ b/zh-cn/application-dev/reference/errorcodes/Readme-CN.md @@ -14,6 +14,7 @@ - [事件错误码](errorcode-CommonEventService.md) - [通知错误码](errorcode-notification.md) - [DistributedNotificationService错误码](errorcode-DistributedNotificationService.md) + - [拖拽事件错误码](errorcode-drag-event.md) - UI界面 - [动画错误码](errorcode-animator.md) - [弹窗错误码](errorcode-promptAction.md) diff --git a/zh-cn/application-dev/reference/errorcodes/errorcode-drag-event.md b/zh-cn/application-dev/reference/errorcodes/errorcode-drag-event.md new file mode 100644 index 0000000000000000000000000000000000000000..d513f10427d3e0d3d73ada75f03887cb633ac864 --- /dev/null +++ b/zh-cn/application-dev/reference/errorcodes/errorcode-drag-event.md @@ -0,0 +1,41 @@ +# 拖拽事件错误码 + +> **说明:** +> +> 以下仅介绍本模块特有错误码,通用错误码请参考[通用错误码说明文档](errorcode-universal.md)。 + +## 190001 数据未取得 + +**错误信息** + +GetData failed, data not found. + +**错误描述** + +当开发者调用DragEvent的GetData()接口时,若还未获取到数据,会抛出此错误码。 + +**可能原因** + +DragEvent的数据暂未获取成功。 + +**处理步骤** + +NA + +## 190002 获取数据错误 + +**错误信息** + +GetData failed, data error. + +**错误描述** + +当开发者调用DragEvent的GetData()接口时,若取得的数据有错误,会抛出此错误码。 + +**可能原因** + +数据获取错误。 + +**处理步骤** + +NA \ No newline at end of file