En esta página

QGraphicsSceneDragDropEvent Class

La clase QGraphicsSceneDragDropEvent proporciona eventos para arrastrar y soltar en el marco de la vista gráfica. Más...

Cabecera: #include <QGraphicsSceneDragDropEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Hereda: QGraphicsSceneEvent

Funciones Públicas

virtual ~QGraphicsSceneDragDropEvent()
void acceptProposedAction()
Qt::MouseButtons buttons() const
Qt::DropAction dropAction() const
const QMimeData *mimeData() const
Qt::KeyboardModifiers modifiers() const
QPointF pos() const
Qt::DropActions possibleActions() const
Qt::DropAction proposedAction() const
QPointF scenePos() const
QPoint screenPos() const
void setDropAction(Qt::DropAction action)
QWidget *source() const

Descripción detallada

QGraphicsView hereda la funcionalidad de arrastrar y soltar proporcionada por QWidget. Cuando recibe un evento de arrastrar y soltar, lo convierte en un QGraphicsSceneDragDropEvent.

QGraphicsSceneDragDropEvent almacena eventos de tipo GraphicsSceneDragEnter, GraphicsSceneDragLeave, GraphicsSceneDragMove o GraphicsSceneDrop.

QGraphicsSceneDragDropEvent contiene la posición del cursor del ratón en coordenadas de elemento, escena y pantalla; esto se puede recuperar con pos(), scenePos() y screenPos().

La escena envía el evento al primer QGraphicsItem bajo el cursor del ratón que acepte drops; un ítem gráfico se configura para aceptar drops con setAcceptDrops().

Documentación de las funciones miembro

[virtual noexcept] QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent()

Destruye el objeto.

void QGraphicsSceneDragDropEvent::acceptProposedAction()

Establece la acción propuesta como aceptada, es decir, la acción de abandono se establece en la acción propuesta. Esto es igual a:

setDropAction(proposedAction());

Cuando se utiliza esta función, no se debe llamar a accept().

Véase también dropAction(), setDropAction() y proposedAction().

Qt::MouseButtons QGraphicsSceneDragDropEvent::buttons() const

Devuelve un valor Qt::MouseButtons que indica qué botones del ratón se pulsaron cuando se generó este evento de ratón.

Véase también Qt::MouseButtons.

Qt::DropAction QGraphicsSceneDragDropEvent::dropAction() const

Devuelve la acción que se realizó en este arrastrar y soltar. Esto debe ser establecido por el receptor del drop y es devuelto por QDrag::exec().

Véase también setDropAction() y acceptProposedAction().

const QMimeData *QGraphicsSceneDragDropEvent::mimeData() const

Esta función devuelve los datos MIME del evento.

Qt::KeyboardModifiers QGraphicsSceneDragDropEvent::modifiers() const

Devuelve los modificadores de teclado que se pulsaron cuando se creó el evento de arrastrar y soltar.

Véase también Qt::KeyboardModifiers.

QPointF QGraphicsSceneDragDropEvent::pos() const

Devuelve la posición del ratón del evento relativa a la vista que envió el evento.

Véase también QGraphicsView, screenPos(), y scenePos().

Qt::DropActions QGraphicsSceneDragDropEvent::possibleActions() const

Devuelve las posibles acciones de arrastrar y soltar.

Véase también Qt::DropActions.

Qt::DropAction QGraphicsSceneDragDropEvent::proposedAction() const

Devuelve la acción drop propuesta, es decir, preferida. La acción debe ser una de las posibles acciones definidas en possibleActions().

Véase también Qt::DropAction y possibleActions().

QPointF QGraphicsSceneDragDropEvent::scenePos() const

Devuelve la posición del ratón en coordenadas de la escena.

Véase también pos() y screenPos().

QPoint QGraphicsSceneDragDropEvent::screenPos() const

Devuelve la posición del ratón respecto a la pantalla.

Véase también pos() y scenePos().

void QGraphicsSceneDragDropEvent::setDropAction(Qt::DropAction action)

Esta función permite al receptor de la caída establecer la acción de caída que se realizó en action, que debe ser una de las possible actions. Llame a accept() en lugar de acceptProposedAction() si utiliza esta función.

Véase también dropAction(), accept(), y possibleActions().

QWidget *QGraphicsSceneDragDropEvent::source() const

Esta función devuelve el QGraphicsView que creó el QGraphicsSceneDragDropEvent.

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