QDrag Class
La clase QDrag permite la transferencia de datos mediante arrastrar y soltar basada en MIME. Más información...
| Encabezado: | #include <QDrag> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QObject |
Funciones públicas
| QDrag(QObject *dragSource) | |
| virtual | ~QDrag() |
| Qt::DropAction | defaultAction() const |
| QPixmap | dragCursor(Qt::DropAction action) const |
| Qt::DropAction | exec(Qt::DropActions supportedActions = Qt::MoveAction) |
| Qt::DropAction | exec(Qt::DropActions supportedActions, Qt::DropAction defaultDropAction) |
| QPoint | hotSpot() const |
| QMimeData * | mimeData() const |
| QPixmap | pixmap() const |
| void | setDragCursor(const QPixmap &cursor, Qt::DropAction action) |
| void | setHotSpot(const QPoint &hotspot) |
| void | setMimeData(QMimeData *data) |
| void | setPixmap(const QPixmap &pixmap) |
| QObject * | source() const |
| Qt::DropActions | supportedActions() const |
| QObject * | target() const |
Señales
| void | actionChanged(Qt::DropAction action) |
| void | targetChanged(QObject *newTarget) |
Miembros públicos estáticos
| void | cancel() |
Descripción detallada
La función de arrastrar y soltar es una forma intuitiva que permite a los usuarios copiar o mover datos dentro de una aplicación, y se utiliza en muchos entornos de escritorio como mecanismo para copiar datos entre aplicaciones. La compatibilidad con la función de arrastrar y soltar en Qt se basa en la clase QDrag, que se encarga de la mayor parte de los detalles de una operación de arrastrar y soltar.
Los datos que se van a transferir mediante la operación de arrastrar y soltar se encuentran en un objeto ` QMimeData `. Esto se especifica con la función ` setMimeData()` de la siguiente manera:
QDrag *drag = new QDrag(this);
QMimeData *mimeData = new QMimeData;
mimeData->setText(commentEdit->toPlainText());
drag->setMimeData(mimeData);Tenga en cuenta que setMimeData() asigna la propiedad del objeto QMimeData al objeto QDrag. El objeto QDrag debe construirse en el montón (heap) con un padre QObject para garantizar que Qt pueda liberar la memoria una vez finalizada la operación de arrastrar y soltar.
Se puede utilizar un mapa de píxeles (pixmap) para representar los datos mientras se realiza el arrastre, y este se desplazará junto con el cursor hasta el destino de la colocación. Este mapa de píxeles suele mostrar un icono que representa el tipo MIME de los datos que se están transfiriendo, pero se puede establecer cualquier mapa de píxeles con setPixmap(). Se puede asignar al punto activo del cursor una posición relativa a la esquina superior izquierda del mapa de píxeles mediante la función ` setHotSpot()`. El siguiente código coloca el mapa de píxeles de manera que el punto activo del cursor apunte al centro de su borde inferior:
drag->setHotSpot(QPoint(drag->pixmap().width()/2,
drag->pixmap().height()));Nota: En X11, es posible que el mapa de píxeles no pueda seguir el ritmo de los movimientos del ratón si el punto activo hace que el mapa de píxeles se muestre directamente debajo del cursor.
Los widgets de origen y destino se pueden localizar mediante source() y target(). Estas funciones se utilizan a menudo para determinar si las operaciones de arrastrar y soltar comenzaron y finalizaron en el mismo widget, de modo que se pueda implementar un comportamiento especial.
QDrag solo se ocupa de la operación de arrastrar y soltar en sí misma. Corresponde al desarrollador decidir cuándo comienza una operación de arrastre y cómo debe crearse y utilizarse un objeto QDrag. Para un widget determinado, suele ser necesario reimplementar mousePressEvent() para determinar si el usuario ha pulsado un botón del ratón, y reimplementar mouseMoveEvent() para comprobar si se requiere un QDrag.
Véase también Arrastrar y soltar, ` QClipboard`, ` QMimeData`, Ejemplo de iconos arrastrables, Ejemplo de texto arrastrable y Ejemplo de zona de colocación.
Documentación de las funciones de miembro
[explicit] QDrag::QDrag(QObject *dragSource)
Crea un nuevo objeto de arrastre para el widget especificado por ` dragSource`.
[virtual noexcept] QDrag::~QDrag()
Elimina el objeto de arrastre.
[signal] void QDrag::actionChanged(Qt::DropAction action)
Esta señal se emite cuando cambia el action asociado al arrastre.
Véase también targetChanged().
[static] void QDrag::cancel()
Cancela una operación de arrastre iniciada por Qt.
Nota: Actualmente está implementado en Windows y X11.
Véase también ` exec()`.
Qt::DropAction QDrag::defaultAction() const
Devuelve la acción de soltar propuesta por defecto para esta operación de arrastrar y soltar.
Véase también exec() y supportedActions().
QPixmap QDrag::dragCursor(Qt::DropAction action) const
Devuelve el cursor de arrastre de la clase ` action`.
Véase también setDragCursor().
Qt::DropAction QDrag::exec(Qt::DropActions supportedActions = Qt::MoveAction)
Inicia la operación de arrastrar y soltar y devuelve un valor que indica la acción de soltar solicitada una vez completada. Las acciones de soltar entre las que puede elegir el usuario se especifican en supportedActions. La acción predeterminada propuesta se seleccionará entre las acciones permitidas en el siguiente orden: Mover, Copiar y Enlazar.
Nota: En Linux y macOS, la operación de arrastrar y soltar puede tardar algún tiempo, pero esta función no bloquea el bucle de eventos. Los demás eventos siguen envíándose a la aplicación mientras se realiza la operación. En Windows, el bucle de eventos de Qt se bloquea durante la operación.
Véase también cancel().
Qt::DropAction QDrag::exec(Qt::DropActions supportedActions, Qt::DropAction defaultDropAction)
Inicia la operación de arrastrar y soltar y devuelve un valor que indica la acción de soltar solicitada una vez completada. Las acciones de soltar entre las que puede elegir el usuario se especifican en supportedActions.
El defaultDropAction determina qué acción se propondrá cuando el usuario realice un arrastre sin utilizar teclas modificadoras.
Nota: En Linux y macOS, la operación de arrastrar y soltar puede tardar algún tiempo, pero esta función no bloquea el bucle de eventos. Los demás eventos siguen enviándose a la aplicación mientras se realiza la operación. En Windows, el bucle de eventos de Qt queda bloqueado durante la operación. Sin embargo, QDrag::exec() en Windows hace que se llame con frecuencia a processEvents() para mantener la capacidad de respuesta de la interfaz gráfica de usuario. Si se invocan bucles u operaciones mientras hay una operación de arrastre activa, esta quedará bloqueada.
QPoint QDrag::hotSpot() const
Devuelve la posición del punto activo respecto a la esquina superior izquierda del cursor.
Véase también setHotSpot().
QMimeData *QDrag::mimeData() const
Devuelve los datos MIME encapsulados por el objeto de arrastre.
Véase también setMimeData().
QPixmap QDrag::pixmap() const
Devuelve el mapa de píxeles utilizado para representar los datos en una operación de arrastrar y soltar.
Véase también setPixmap().
void QDrag::setDragCursor(const QPixmap &cursor, Qt::DropAction action)
Establece el cursor de arrastre cursor para action. Esto te permite anular los cursores nativos predeterminados. Para volver a utilizar el cursor nativo de action, pasa un QPixmap nulo como cursor.
Nota: es posible que la configuración del cursor de arrastre para IgnoreAction no funcione en todas las plataformas. Se ha comprobado que funciona en X11 y macOS. Windows no lo admite.
Véase también dragCursor().
void QDrag::setHotSpot(const QPoint &hotspot)
Establece la posición del punto activo con respecto a la esquina superior izquierda del mapa de píxeles utilizado en el punto especificado por ` hotspot`.
Nota: en X11, es posible que el mapa de píxeles no pueda seguir el ritmo de los movimientos del ratón si el punto activo hace que el mapa de píxeles se muestre directamente debajo del cursor.
Véase también hotSpot().
void QDrag::setMimeData(QMimeData *data)
Establece los datos que se enviarán al tipo MIME especificado data. La propiedad de los datos se transfiere al objeto QDrag.
Véase también mimeData().
void QDrag::setPixmap(const QPixmap &pixmap)
Establece ` pixmap ` como el mapa de píxeles utilizado para representar los datos en una operación de arrastrar y soltar. Solo se puede establecer un mapa de píxeles antes de iniciar el arrastre.
Véase también pixmap().
QObject *QDrag::source() const
Devuelve el origen del objeto de arrastre. Se trata del widget en el que se inició la operación de arrastrar y soltar.
Qt::DropActions QDrag::supportedActions() const
Devuelve el conjunto de acciones de soltar posibles para esta operación de arrastrar.
Véase también exec() y defaultAction().
QObject *QDrag::target() const
Devuelve el destino de la operación de arrastrar y soltar. Se trata del widget en el que se soltó el objeto arrastrado.
[signal] void QDrag::targetChanged(QObject *newTarget)
Esta señal se emite cuando cambia el destino de la operación de arrastrar y soltar, siendo newTarget el nuevo destino.
Véanse también target() y actionChanged().
© 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.