QDropEvent Class
La clase QDropEvent proporciona un evento que se envía cuando se completa una acción de arrastrar y soltar. Más...
| Cabecera: | #include <QDropEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Hereda: | QEvent |
| Heredado por: |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QDropEvent es parte de Clases de Eventos.
Funciones Públicas
| QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop) | |
| void | acceptProposedAction() |
(since 6.0) Qt::MouseButtons | buttons() const |
| Qt::DropAction | dropAction() const |
| const QMimeData * | mimeData() const |
(since 6.0) Qt::KeyboardModifiers | modifiers() const |
(since 6.0) QPointF | position() const |
| Qt::DropActions | possibleActions() const |
| Qt::DropAction | proposedAction() const |
| void | setDropAction(Qt::DropAction action) |
| QObject * | source() const |
Descripción Detallada
Cuando un widget accepts drop events, recibirá este evento si ha aceptado el más reciente QDragEnterEvent o QDragMoveEvent enviado a él.
El evento drop contiene una acción propuesta, disponible en proposedAction(), para que el widget la acepte o la ignore. Si la acción puede ser manejada por el widget, debe llamar a la función acceptProposedAction(). Dado que la acción propuesta puede ser una combinación de valores de Qt::DropAction, puede ser útil seleccionar uno de estos valores como acción por defecto o pedir al usuario que seleccione su acción preferida.
Si la acción de soltar propuesta no es adecuada, quizás porque su widget personalizado no admite esa acción, puede sustituirla por cualquiera de las possible drop actions llamando a setDropAction() con su acción preferida. Si establece un valor que no está presente en la combinación bitwise OR de los valores devueltos por possibleActions(), se utilizará la acción de copia por defecto. Una vez establecida una acción de caída de sustitución, llame a accept() en lugar de a acceptProposedAction() para completar la operación de caída.
La función mimeData() proporciona los datos soltados en el widget en un objeto QMimeData. Éste contiene información sobre el tipo MIME de los datos, además de los propios datos.
Véase también QMimeData, QDrag, y Arrastrar y soltar.
Documentación de las funciones miembro
QDropEvent::QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop)
Construye un evento drop de un determinado type correspondiente a un drop en el punto especificado por pos en el sistema de coordenadas del widget de destino.
actions indica qué tipos de operaciones de arrastrar y soltar se pueden realizar, y los datos de arrastre se almacenan como datos codificados MIME en data.
Los estados de los botones del ratón y de los modificadores del teclado en el momento de la operación de arrastrar y soltar se especifican en buttons y modifiers.
void QDropEvent::acceptProposedAction()
Establece que la acción drop sea la acción propuesta.
Véase también setDropAction(), proposedAction() y accept().
[since 6.0] Qt::MouseButtons QDropEvent::buttons() const
Devuelve los botones del ratón que están pulsados.
Esta función se introdujo en Qt 6.0.
Qt::DropAction QDropEvent::dropAction() const
Devuelve la acción que realizará el destino sobre los datos. Puede ser diferente de la acción suministrada en proposedAction() si ha llamado a setDropAction() para elegir explícitamente una acción de soltar.
Véase también setDropAction().
const QMimeData *QDropEvent::mimeData() const
Devuelve los datos que se han soltado en el widget y su información de tipo MIME asociada.
[since 6.0] Qt::KeyboardModifiers QDropEvent::modifiers() const
Devuelve las teclas modificadoras pulsadas.
Esta función se introdujo en Qt 6.0.
[since 6.0] QPointF QDropEvent::position() const
Devuelve la posición en la que se realizó la caída.
Esta función se introdujo en Qt 6.0.
Qt::DropActions QDropEvent::possibleActions() const
Devuelve una combinación OR de posibles acciones de caída.
Véase también dropAction().
Qt::DropAction QDropEvent::proposedAction() const
Devuelve la acción de abandono propuesta.
Véase también dropAction().
void QDropEvent::setDropAction(Qt::DropAction action)
Establece el action que el destino realizará en los datos. Utilícelo para sustituir proposed action por una de las acciones de possible actions.
Si estableces una acción de soltar que no es una de las posibles, la operación de arrastrar y soltar será por defecto una operación de copia.
Una vez que haya proporcionado una acción de soltar de sustitución, llame a accept() en lugar de a acceptProposedAction().
Véase también dropAction().
QObject *QDropEvent::source() const
Si el origen de la operación de arrastre es un widget de esta aplicación, esta función devuelve dicho origen; en caso contrario, devuelve nullptr. El origen de la operación es el primer parámetro del objeto QDrag utilizado para instanciar el arrastre.
Esto es útil si tu widget necesita un comportamiento especial cuando se arrastra a sí mismo.
Véase también QDrag::QDrag().
© 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.
