En esta página

Qt Quick Ejemplos: arrastrar y soltar

Esta es una recopilación de ejemplos de arrastrar y soltar en QML.

Fichas rojas y azules numeradas que se arrastran entre zonas de colocación

«Arrastrar y soltar » es una recopilación de pequeños ejemplos en QML relacionados con la funcionalidad de arrastrar y soltar. Para obtener más información, visita la página «Arrastrar y soltar ».

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Mosaicos

«Tiles» añade la función de arrastrar y soltar a rectángulos sencillos, que puedes arrastrar a una cuadrícula específica.

Cuenta con un componente DragTile que utiliza un MouseArea para mover un elemento al arrastrarlo:

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
                    }
                }
            }
        }
    }
}

Y un componente «DropTile» en el que se pueden soltar los mosaicos arrastrados:

DropArea {
    id: dragTarget

    property string colorKey

    width: 64
    height: 64
    keys: [ colorKey ]

    Rectangle {
        id: dropRectangle

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

La propiedad «keys» del ` DropArea ` solo permitirá soltar un elemento en él si este tiene una clave coincidente en su propiedad «Drag.keys».

Ejemplo de GridView

El ejemplo «GridView » añade la función de arrastrar y soltar a un « GridView », lo que permite reordenar visualmente los delegados sin modificar el « ListModel » subyacente. Utiliza un « DelegateModel » para mover un elemento delegado a la posición de otro elemento sobre el que se arrastra.

    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
            }
        }

Proyecto de ejemplo en code.qt.io

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