!23287 新增drag event 里getData的异常描述

Merge pull request !23287 from FredTT/temp828

zh-cn/application-dev/reference/arkui-ts/ts-universal-events-drag-drop.md

@@ -55,7 +55,7 @@ ArkUI组件默认支持拖拽。
 | ------ | ------ | ---------------- |
 | useCustomDropAnimation<sup>10+</sup> | boolean | 当拖拽结束时，是否使用系统默认落入动画。 |
 | setData(unifiedData: [UnifiedData](../apis/js-apis-data-unifiedDataChannel.md#unifieddata))<sup>10+</sup> | void | 向DragEvent中设置拖拽相关数据。 |
-| getData()<sup>10+</sup> | [UnifiedData](../apis/js-apis-data-unifiedDataChannel.md#unifieddata) | 从DragEvent中获取拖拽相关数据。 |
+| getData()<sup>10+</sup> | [UnifiedData](../apis/js-apis-data-unifiedDataChannel.md#unifieddata) | 从DragEvent中获取拖拽相关数据。数据获取结果请参考错误码说明。 |
 | getSummary()<sup>10+</sup> | [Summary](../apis/js-apis-data-unifiedDataChannel.md#summary) | 从DragEvent中获取拖拽相关数据的简介。 |
 | setResult(dragRect: [DragResult](#dragresult10枚举说明))<sup>10+</sup> | void | 向DragEvent中设置拖拽结果。 |
 | getResult()<sup>10+</sup> | [DragResult](#dragresult10枚举说明) | 从DragEvent中获取拖拽结果。 |
@@ -70,6 +70,15 @@ ArkUI组件默认支持拖拽。
 | getX()<sup>(deprecated)</sup> | number | 当前拖拽点相对于窗口左上角的x轴坐标，单位为vp。<br>从API verdion 10开始不再维护，建议使用getWindowX()代替。 |
 | getY()<sup>(deprecated)</sup> | number | 当前拖拽点相对于窗口左上角的y轴坐标，单位为vp。<br>从API verdion 10开始不再维护，建议使用getWindowY()代替。 |
 
+**错误码：**
+
+以下错误码的详细介绍请参见[drag-event(拖拽事件)](../errorcodes/errorcode-drag-event.md)错误码。
+
+| 错误码ID   | 错误信息 |
+| --------- | ------- |
+| 190001    | GetData failed, data not found. |
+| 190002    | GetData failed, data error. |
+
 ## DragResult<sup>10+</sup>枚举说明
 
 | 名称 | 描述 |
@@ -100,16 +109,21 @@ struct Index {
 
   getDataFromUdmfRetry(event: DragEvent, callback: (data: DragEvent)=>void)
   {
-    let data = event.getData();
-    if (!data) {
-      return false;
-    }
-    let records: Array<UDC.UnifiedRecord> = data.getRecords();
-    if (!records || records.length <= 0) {
+    try {
+      let data = event.getData();
+      if (!data) {
+        return false;
+      }
+      let records: Array<UDC.UnifiedRecord> = 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)

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)

zh-cn/application-dev/reference/errorcodes/errorcode-drag-event.md

+# 拖拽事件错误码
+
+> **说明：**
+>
+> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](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