• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 拖拽事件(系统接口)
2<!--Kit: ArkUI-->
3<!--Subsystem: ArkUI-->
4<!--Owner: @jiangtao92-->
5<!--Designer: @piggyguy-->
6<!--Tester: @songyanhong-->
7<!--Adviser: @HelloCrease-->
8
9拖拽事件是指在用户界面中,当用户拖动某个对象(如文件、控件或元素)时触发的一系列事件。这些事件允许开发者自定义拖拽行为,实现诸如拖放、调整位置等功能。
10
11>  **说明:**
12>
13>  从API version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
14>
15> 应用本身预置的资源文件(即应用在安装前的HAP包中已经存在的资源文件)仅支持本地应用内拖拽。
16>
17> 本文仅介绍当前模块的系统接口,其他公开接口参见[拖拽事件](ts-universal-events-drag-drop.md)。
18
19## DragEvent<sup>7+</sup>
20
21拖拽事件信息。
22
23### enableInternalDropAnimation<sup>20+</sup>
24
25enableInternalDropAnimation(configuration: string): void
26
27使用系统的内置动效,且该动效只有系统应用可使用。仅支持在onDrop阶段使用。
28
29**系统接口:** 此接口为系统接口。
30
31**系统能力:** SystemCapability.ArkUI.ArkUI.Full
32
33**参数:**
34| 参数名    | 类型                                      | 必填 | 说明                               |
35| --------- | ----------------------------------------- | ---- | ---------------------------------- |
36| configuration | string | 是   | 动效配置参数,字符串内容为json格式。 |
37
38**错误码:**
39
40以下错误码的详细介绍请参见[通用错误码](../../errorcode-universal.md)和[drag-event(拖拽事件)](../errorcode-drag-event.md)错误码。
41
42| 错误码ID   | 错误信息 |
43| --------- | ------- |
44| 202       | Permission verification failed, application which is not a system application uses system API. |
45| 801       | Capability not supported.|
46| 190003    | Operation not allowed for current phase. |
47