En esta página

Ejemplo de iconos arrastrables

El ejemplo de iconos arrastrables muestra cómo arrastrar y soltar datos de imagen entre widgets de la misma aplicación y entre diferentes aplicaciones.

Aplicación con iconos que responden a eventos de arrastrar y soltar

En muchas situaciones en las que se utiliza la función de arrastrar y soltar, el usuario comienza a arrastrar desde un widget concreto y suelta el contenido en otro widget. En este ejemplo, creamos una subclase de ` QLabel ` para crear etiquetas que utilizamos como fuentes de arrastre, y las colocamos dentro de elementos ` QWidget` que sirven tanto de contenedores como de destinos de soltar.

Además, cuando se produce una operación de arrastrar y soltar, queremos enviar algo más que una simple imagen. También queremos enviar información sobre el punto de la imagen en el que el usuario ha hecho clic, para que pueda colocarla con precisión en el destino de colocación. Este nivel de detalle implica que debemos crear un tipo MIME personalizado para nuestros datos.

Definición de la clase DragWidget

Los widgets de iconos que utilizamos para mostrar iconos son subclases de ` QLabel`:

class DragWidget : public QFrame
{
public:
    explicit DragWidget(QWidget *parent = nullptr);

protected:
    void dragEnterEvent(QDragEnterEvent *event) override;
    void dragMoveEvent(QDragMoveEvent *event) override;
    void dropEvent(QDropEvent *event) override;
    void mousePressEvent(QMouseEvent *event) override;
};

Dado que la clase ` QLabel ` proporciona la mayor parte de lo que necesitamos para el icono, solo tenemos que reimplementar el método ` QWidget::mousePressEvent()` para ofrecer la funcionalidad de arrastrar y soltar.

Implementación de la clase DragWidget

El constructor de ` DragWidget ` establece un atributo en el widget que garantiza que se eliminará cuando se cierre:

DragWidget::DragWidget(QWidget *parent)
    : QFrame(parent)
{
    setMinimumSize(200, 200);
    setFrameStyle(QFrame::Sunken | QFrame::StyledPanel);
    setAcceptDrops(true);

    QLabel *boatIcon = new QLabel(this);
    boatIcon->setPixmap(QPixmap(":/images/boat.png"));
    boatIcon->move(10, 10);
    boatIcon->show();
    boatIcon->setAttribute(Qt::WA_DeleteOnClose);

    QLabel *carIcon = new QLabel(this);
    carIcon->setPixmap(QPixmap(":/images/car.png"));
    carIcon->move(100, 10);
    carIcon->show();
    carIcon->setAttribute(Qt::WA_DeleteOnClose);

    QLabel *houseIcon = new QLabel(this);
    houseIcon->setPixmap(QPixmap(":/images/house.png"));
    houseIcon->move(10, 80);
    houseIcon->show();
    houseIcon->setAttribute(Qt::WA_DeleteOnClose);
}

Para permitir arrastrar desde el icono, debemos responder a un evento de pulsación del ratón. Para ello, reimplementamos el método ` QWidget::mousePressEvent()` y configuramos un objeto ` QDrag `.

void DragWidget::mousePressEvent(QMouseEvent *event)
{
    QLabel *child = static_cast<QLabel*>(childAt(event->position().toPoint()));
    if (!child)
        return;

    QPixmap pixmap = child->pixmap();

    QByteArray itemData;
    QDataStream dataStream(&itemData, QIODevice::WriteOnly);
    dataStream << pixmap << QPoint(event->position().toPoint() - child->pos());

Dado que vamos a enviar datos de mapa de píxeles para el icono e información sobre el clic del usuario en el widget del icono, creamos un ` QByteArray ` y agrupamos los detalles utilizando un ` QDataStream`.

Para garantizar la interoperabilidad, las operaciones de arrastrar y soltar describen los datos que contienen mediante tipos MIME. En Qt, describimos estos datos utilizando un objeto ` QMimeData `:

    QMimeData *mimeData = new QMimeData;
    mimeData->setData("application/x-dnditemdata", itemData);

Elegimos un tipo MIME no oficial para este fin y proporcionamos el ` QByteArray ` al objeto de datos MIME.

La operación de arrastrar y soltar en sí misma la gestiona un objeto ` QDrag `:

    QDrag *drag = new QDrag(this);
    drag->setMimeData(mimeData);
    drag->setPixmap(pixmap);
    drag->setHotSpot(event->position().toPoint() - child->pos());

Aquí, pasamos los datos al objeto de arrastre, establecemos un mapa de píxeles que se mostrará junto al cursor durante la operación y definimos la posición de un punto activo que sitúa dicho mapa de píxeles debajo del cursor.

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.