DropArea QML Type

For specifying drag and drop handling in an area. More...

Import Statement: import QtQuick
Inherits:

Item

Properties

Signals

Detailed Description

A DropArea is an invisible item which receives events when other items are dragged over it.

The Drag attached property can be used to notify the DropArea when an Item is dragged over it.

The keys property can be used to filter drag events which don't include a matching key.

The drag.source property is communicated to the source of a drag event as the recipient of a drop on the drag target.

See also Qt Quick Examples - Drag and Drop and Qt Quick Examples - externaldraganddrop.

Property Documentation

[read-only] containsDrag : bool

This property identifies whether the DropArea currently contains any dragged items.


drag group

[read-only] drag.x : qreal

[read-only] drag.y : qreal

These properties hold the coordinates of the last drag event.


[read-only] drag.source : QtObject

This property holds the source of a drag.


keys : stringlist

This property holds a list of drag keys a DropArea will accept.

If no keys are listed the DropArea will accept events from any drag source, otherwise the drag source must have at least one compatible key.

See also QtQuick::Drag::keys.


Signal Documentation

dropped(DragEvent drop)

This signal is emitted when a drop event occurs within the bounds of a DropArea.

Note: The corresponding handler is onDropped.


entered(DragEvent drag)

This signal is emitted when a drag enters the bounds of a DropArea.

Note: The corresponding handler is onEntered.


exited()

This signal is emitted when a drag exits the bounds of a DropArea.

Note: The corresponding handler is onExited.


positionChanged(DragEvent drag)

This signal is emitted when the position of a drag has changed.

Note: The corresponding handler is onPositionChanged.


© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.