- Qt 6.9
- Qt Quick
- QML Types
- DragEvent
- Qt 6.9.0 Reference Documentation

# DragEvent QML Type

Provides information about a drag event. More...

Import Statement: | `import QtQuick`

- List of all members, including inherited members

## Properties

- accepted : bool
- action : enumeration
- colorData : color
- drag.source : QtObject
- formats : stringlist
- hasColor : bool
- hasHtml : bool
- hasText : bool
- hasUrls : bool
- html : string
- keys : stringlist
- proposedAction : flags
- supportedActions : flags
- text : string
- urls : urllist
- x : real
- y : real

## Methods

- accept()
- accept(enumeration action)
- acceptProposedAction()
- string getDataAsArrayBuffer(string format)
- string getDataAsString(string format)

## Detailed Description

The position of the drag event can be obtained from the x and y properties, and the keys property identifies the drag keys of the event source.

The existence of specific drag types can be determined using the hasColor, hasHtml, hasText, and hasUrls properties.

The list of all supplied formats can be determined using the formats property.

Specific drag types can be obtained using the colorData, html, text, and urls properties.

A string version of any available mimeType can be obtained using getDataAsString.

## Property Documentation

accepted : bool

This property holds whether the drag event was accepted by a handler.

The default value is true.

action : enumeration

This property holds the action that the source is to perform on an accepted drop.

The drop action may be one of:

Constant | Description
--- | ---
`Qt.CopyAction` | Copy the data to the target.
`Qt.MoveAction` | Move the data from the source to the target.
`Qt.LinkAction` | Create a link from the source to the target.
`Qt.IgnoreAction` | Ignore the action (do nothing with the data).

colorData : color `[read-only]`

This property holds color data, if any.

drag.source : QtObject

This property holds the source of a drag event.

formats : stringlist `[read-only]`

This property holds a list of mime type formats contained in the drag data.

hasColor : bool `[read-only]`

This property holds whether the drag event contains a color item.

hasHtml : bool `[read-only]`

This property holds whether the drag event contains a html item.

hasText : bool `[read-only]`

This property holds whether the drag event contains a text item.

hasUrls : bool `[read-only]`

This property holds whether the drag event contains one or more url items.

html : string `[read-only]`

This property holds html data, if any.

keys : stringlist `[read-only]`

This property holds a list of keys identifying the data type or source of a drag event.

proposedAction : flags `[read-only]`

This property holds the set of actions proposed by the drag source.

supportedActions : flags `[read-only]`

This property holds the set of actions supported by the drag source.

text : string `[read-only]`

This property holds text data, if any.

urls : urllist `[read-only]`

This property holds a list of urls, if any.

x : real `[read-only]`

This property holds the x coordinate of a drag event.

y : real `[read-only]`

This property holds the y coordinate of a drag event.

## Method Documentation

accept()
accept(enumeration action)

Accepts the drag event.

If an action is specified it will overwrite the value of the action property.

acceptProposedAction()

Accepts the drag event with the proposedAction.

string getDataAsArrayBuffer(string format)

Returns the data for the given format into an ArrayBuffer, which can easily be translated into a QByteArray. format should be one contained in the formats property.

string getDataAsString(string format)

Returns the data for the given format converted to a string. format should be one contained in the formats property.