- Qt 6.8
- Qt Quick
- Qt Quick Examples - Drag and Drop
- Qt 6.8.3 Reference Documentation

# Qt Quick Examples - Drag and Drop

This is a collection of QML drag and drop examples.

Drag and Drop is a collection of small QML examples relating to the drag and drop functionality. For more information, visit the Drag and Drop page.

#### Running the Example

To run the example from Qt Creator, open the Welcome mode and select the example from Examples. For more information, see Qt Creator: Tutorial: Build and run.

#### Tiles

Tiles adds drag and drop to simple rectangles, which you can drag into a specific grid.

It has a DragTile component which uses a MouseArea to move an item when dragged:

     Item {
         id: root

         required property string colorKey
         required property int modelData

         width: 64
         height: 64

         MouseArea {
             id: mouseArea

             width: 64
             height: 64
             anchors.centerIn: parent

             drag.target: tile

             onReleased: parent = tile.Drag.target !== null ? tile.Drag.target : root

             Rectangle {
                 id: tile

                 width: 64
                 height: 64
                 anchors {
                     verticalCenter: parent.verticalCenter
                     horizontalCenter: parent.horizontalCenter
                 }

                 color: root.colorKey

                 Drag.keys: [ root.colorKey ]
                 Drag.active: mouseArea.drag.active
                 Drag.hotSpot.x: 32
                 Drag.hotSpot.y: 32
                 states: State {
                     when: mouseArea.drag.active
                     AnchorChanges {
                         target: tile
                         anchors {
                             verticalCenter: undefined
                             horizontalCenter: undefined
                         }
                     }
                 }
             }
         }
     }

And a DropTile component on which the dragged tiles can be dropped:

     DropArea {
         id: dragTarget

         property string colorKey

         width: 64
         height: 64
         keys: [ colorKey ]

         Rectangle {
             id: dropRectangle

             anchors.fill: parent
             color: dragTarget.containsDrag ? "grey" : dragTarget.colorKey
         }
     }

The keys property of the DropArea will only allow an item to be dropped on it if it has a matching key in its Drag.keys property.

#### GridView Example

The GridView Example adds drag and drop to a GridView, allowing you to visually reorder the delegates without changing the underlying ListModel. It uses a DelegateModel to move a delegate item to the position of another item it is dragged over.

         model: DelegateModel {
             delegate: DropArea {
                 id: delegateRoot
                 required property color color

                 width: 80
                 height: 80

                 onEntered: function(drag) {
                     visualModel.items.move((drag.source as Icon).visualIndex, icon.visualIndex)
                 }

                 property int visualIndex: DelegateModel.itemsIndex

                 Icon {
                     id: icon
                     dragParent: root
                     visualIndex: delegateRoot.visualIndex
                     color: delegateRoot.color
                 }
             }

Example project @ code.qt.io