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