En esta página

QGraphicsSceneDragDropEvent Class

La clase `QGraphicsSceneDragDropEvent` proporciona eventos para la función de arrastrar y soltar en el marco de trabajo de la vista gráfica. Más información...

Encabezado: #include <QGraphicsSceneDragDropEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredan: 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 Heredan la funcionalidad de arrastrar y soltar que proporciona 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 tanto en coordenadas de elemento como de escena y de pantalla; esto se puede obtener mediante ` pos()`, ` scenePos()` y ` screenPos()`.

La escena envía el evento al primer elemento de tipo « QGraphicsItem » situado bajo el cursor del ratón que admita sueltes; un elemento gráfico se configura para admitir sueltes mediante setAcceptDrops().

Documentación de 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 soltar se establece como la acción propuesta. Esto equivale a:

setDropAction(proposedAction());

Al utilizar esta función, no se debe llamar a accept().

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

Qt::MouseButtons QGraphicsSceneDragDropEvent::buttons() const

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

Véase también Qt::MouseButtons.

Qt::DropAction QGraphicsSceneDragDropEvent::dropAction() const

Devuelve la acción que se ha realizado en esta operación de arrastrar y soltar. Esta acción debe ser establecida por el receptor de la acción de soltar y es devuelta por la función ` 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 del teclado que se pulsaron cuando se generó 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 en relación con la vista que envió el evento.

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

Qt::DropActions QGraphicsSceneDragDropEvent::possibleActions() const

Devuelve las posibles acciones de soltar en las que puede dar lugar la operación de arrastrar y soltar.

Véase también Qt::DropActions.

Qt::DropAction QGraphicsSceneDragDropEvent::proposedAction() const

Devuelve la acción de soltar propuesta, es decir, la preferida. La acción debe ser una de las posibles 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 escena.

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

QPoint QGraphicsSceneDragDropEvent::screenPos() const

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

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

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

Esta función permite al destinatario de la entrega establecer la acción de entrega que se ha realizado en action, que debe ser una de las opciones de possible actions. Si utilizas esta función, llama a accept() en lugar de acceptProposedAction().

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

QWidget *QGraphicsSceneDragDropEvent::source() const

Esta función devuelve el objeto « QGraphicsView » que creó el objeto « 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.