QDrag Class

        QDrag *drag = new QDrag(this);
        QMimeData *mimeData = new QMimeData;

        mimeData->setText(commentEdit->toPlainText());
        drag->setMimeData(mimeData);

    drag->setHotSpot(QPoint(drag->pixmap().width()/2,
                            drag->pixmap().height()));

Documentación de funciones miembro

[explicit] QDrag::QDrag(QObject *dragSource)

Construye un nuevo objeto de arrastre para el widget especificado por dragSource.

[virtual noexcept] QDrag::~QDrag()

Destruye 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.

Véase también exec().

Qt::DropAction QDrag::defaultAction() const

Devuelve la acción de soltar propuesta por defecto para esta operación de arrastre.

Véase también exec() y supportedActions().

QPixmap QDrag::dragCursor(Qt::DropAction action) const

Devuelve el cursor de arrastre de 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 cuando finaliza. Las acciones de soltar entre las que el usuario puede elegir se especifican en supportedActions. Se seleccionará la acción propuesta por defecto 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. Otros eventos siguen llegando 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 cuando finaliza. Las acciones de soltar entre las que puede elegir el usuario se especifican en supportedActions.

La dirección 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. Otros eventos siguen llegando a la aplicación mientras se realiza la operación. En Windows, el bucle de eventos de Qt se bloquea durante la operación. Sin embargo, QDrag::exec() en Windows hace que processEvents() sea llamada frecuentemente para mantener la respuesta de la GUI. Si se llama a cualquier bucle u operación mientras una operación de arrastre está activa, se bloqueará la operación de arrastre.

QPoint QDrag::hotSpot() const

Devuelve la posición del punto caliente 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 pixmap 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 arrastre cursor para el action. Esto le permite anular los cursores nativos por defecto. Para volver a utilizar el cursor nativo para action pase un QPixmap nulo como cursor.

Nota: la configuración del cursor de arrastre para IgnoreAction puede no funcionar en todas las plataformas. Se ha comprobado que funciona en X11 y macOS. Windows no lo soporta.

Véase también dragCursor().

void QDrag::setHotSpot(const QPoint &hotspot)

Establece la posición del punto caliente en relación con 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 los movimientos del ratón si el punto caliente hace que el mapa de píxeles se muestre directamente bajo el cursor.

Véase también hotSpot().

void QDrag::setMimeData(QMimeData *data)

Establece los datos que se enviarán al MIME 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 pixmap utilizado para representar los datos en una operación de arrastrar y soltar. Sólo se puede establecer un pixmap antes de que se inicie 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 originó la operación de arrastrar y soltar.

Qt::DropActions QDrag::supportedActions() const

Devuelve el conjunto de posibles acciones de soltar para esta operación de arrastre.

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éase también target() y actionChanged().