Qt Quick Ejemplos: arrastrar y soltar
Esta es una recopilación de ejemplos de arrastrar y soltar en QML.

«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:
- Qt Creator
Abre el modo « Welcome » y selecciona el ejemplo en Examples. Para obtener más información, consulta Qt Creator: Tutorial: Compilar y ejecutar.
- Qt Extension for Visual Studio Code
Ejecute el comando « Qt: Open Qt examples » desde Command Palette y seleccione el ejemplo de la lista. Para obtener más información, consulte Qt Extension for Visual Studio Code: Tutorial: Compilar y ejecutar.
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
}
}© 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.