DropArea QML Type

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

Import Statement: import QtQuick 2.14

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

containsDrag : bool

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


drag group

drag.x : qreal

drag.y : qreal

These properties hold the coordinates of the last drag event.


drag.source : Object

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(drop)

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

The corresponding handler is onDropped.


entered(drag)

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

The corresponding handler is onEntered.


exited()

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

The corresponding handler is onExited.


positionChanged(drag)

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

The corresponding handler is onPositionChanged.


© 2020 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.