En esta página

QDragMoveEvent Class

La clase QDragMoveEvent proporciona un evento que se envía mientras se está llevando a cabo una acción de arrastrar y soltar. Más información...

Encabezado: #include <QDragMoveEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Heredado de: QDropEvent
Heredado por:

QDragEnterEvent

Funciones públicas

QDragMoveEvent(QPointF pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = DragMove)
void accept(const QRect &rectangle)
void accept()
QRect answerRect() const
void ignore(const QRect &rectangle)
void ignore()

Funciones protegidas

QDragMoveEvent(QDragMoveEvent &&)
QDragMoveEvent &operator=(QDragMoveEvent &&)
QDragMoveEvent &operator=(const QDragMoveEvent &other)

Descripción detallada

Un control recibirá eventos de arrastre y desplazamiento de forma repetida mientras el arrastre se encuentre dentro de sus límites, si acepta ` drop events ` y ` enter events`. El control debe examinar el evento para ver qué tipo de ` data ` proporciona y llamar a la función ` accept()` para aceptar la colocación si procede.

El rectángulo proporcionado por la función answerRect() puede utilizarse para restringir los arrastres a determinadas partes del widget. Por ejemplo, podemos comprobar si el rectángulo se cruza con la geometría de un determinado widget hijo y llamar a acceptProposedAction() solo si ese es el caso.

Ten en cuenta que esta clase hereda la mayor parte de su funcionalidad de ` QDropEvent`.

Véase también QDragEnterEvent, QDragLeaveEvent y QDropEvent.

Documentación de las funciones miembro

QDragMoveEvent::QDragMoveEvent(QPointF pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = DragMove)

Crea un QDragMoveEvent con el type requerido, indicando que el ratón se encuentra en la posición pos especificada dentro de un widget.

Los estados del ratón y del teclado se especifican mediante buttons y modifiers, y actions describen los tipos de operaciones de arrastrar y soltar que son posibles. Los datos de arrastre se pasan como información codificada en MIME en data.

Advertencia: No intentes crear un QDragMoveEvent por tu cuenta. Estos objetos dependen del estado interno de Qt.

[protected delete] QDragMoveEvent::QDragMoveEvent(QDragMoveEvent &&)

Crea una instancia de ` QDragMoveEvent` mediante «move». Esta función ha sido eliminada.

void QDragMoveEvent::accept(const QRect &rectangle)

Es igual que `accept()`, pero además indica que los movimientos futuros también serán aceptados si se mantienen dentro del ` rectangle ` especificado en el widget. Esto puede mejorar el rendimiento, aunque el sistema subyacente también puede ignorarlo.

Si el rectángulo está vacío, se enviarán eventos de arrastre de forma continua. Esto resulta útil si el elemento de origen se está desplazando en un evento de temporizador.

void QDragMoveEvent::accept()

Llama a ` QDropEvent::accept()`.

Esta es una función sobrecargada.

QRect QDragMoveEvent::answerRect() const

Devuelve el rectángulo del widget en el que se realizará el arrastre si se acepta. Puedes utilizar esta información para limitar los arrastres a determinados lugares del widget.

void QDragMoveEvent::ignore(const QRect &rectangle)

Lo contrario de la función «accept(const QRect&)». Los movimientos dentro del « rectangle » no son válidos y se ignorarán.

void QDragMoveEvent::ignore()

Llama a ` QDropEvent::ignore()`.

Esta es una función sobrecargada.

[protected delete] QDragMoveEvent &QDragMoveEvent::operator=(QDragMoveEvent &&)

Asigna mediante «move» other a esta instancia de QDragMoveEvent. Esta función se elimina.

[noexcept protected default] QDragMoveEvent &QDragMoveEvent::operator=(const QDragMoveEvent &other)

Asigna por copia other a esta instancia de QDragMoveEvent.

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