QDropEvent Class
La clase QDropEvent proporciona un evento que se envía cuando finaliza una acción de arrastrar y soltar. Más información...
| Encabezado: | #include <QDropEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Heredado de: | QEvent |
| Heredado por: |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QDropEvent forma parte de las 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 |
Funciones protegidas
| QDropEvent(QDropEvent &&) | |
| QDropEvent & | operator=(QDropEvent &&) |
| QDropEvent & | operator=(const QDropEvent &other) |
Descripción detallada
Cuando un widget accepts drop events, recibirá este evento si ha aceptado el último QDragEnterEvent o QDragMoveEvent que se le haya enviado.
El evento de soltar contiene una acción propuesta, disponible a través de ` proposedAction()` (), que el widget puede aceptar o ignorar. Si el widget puede gestionar la acción, debes llamar a la función acceptProposedAction(). Dado que la acción propuesta puede ser una combinación de valores de Qt::DropAction, puede resultar útil seleccionar uno de estos valores como acción predeterminada o pedir al usuario que seleccione su acción preferida.
Si la acción de soltar propuesta no es adecuada, quizá porque tu widget personalizado no admite esa acción, puedes sustituirla por cualquiera de las possible drop actions llamando a setDropAction() con la acción que prefieras. Si se establece un valor que no está presente en la combinación OR bit a bit de los valores devueltos por possibleActions(), se utilizará la acción de copia por defecto. Una vez establecida una acción de soltar sustitutiva, llame a accept() en lugar de acceptProposedAction() para completar la operación de soltar.
La función mimeData() proporciona los datos soltados en el widget en un objeto QMimeData. Este 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 de miembro
QDropEvent::QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop)
Crea un evento de soltar de un tipo determinado type correspondiente a una acción de soltar en el punto especificado por pos en el sistema de coordenadas del widget de destino.
El actions indica qué tipos de operaciones de arrastrar y soltar se pueden realizar, y los datos de arrastre se almacenan como datos codificados en MIME en data.
Los estados de los botones del ratón y de los modificadores del teclado en el momento de la colocación se especifican mediante buttons y modifiers.
[protected delete] QDropEvent::QDropEvent(QDropEvent &&)
Crea una instancia de ` QDropEvent`. Esta función se ha eliminado.
void QDropEvent::acceptProposedAction()
Establece la acción al soltar el elemento como 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 el destino debe realizar sobre los datos. Esta puede ser diferente de la acción proporcionada en ` proposedAction()` si has llamado a ` setDropAction()` para seleccionar explícitamente una acción de eliminación.
Véase también setDropAction().
const QMimeData *QDropEvent::mimeData() const
Devuelve los datos que se han soltado en el widget y la información sobre su tipo MIME asociada.
[since 6.0] Qt::KeyboardModifiers QDropEvent::modifiers() const
Devuelve las teclas modificadoras que están 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ó el arrastre.
Esta función se introdujo en Qt 6.0.
Qt::DropActions QDropEvent::possibleActions() const
Devuelve una combinación «OR» de posibles acciones de suelta.
Véase también dropAction().
Qt::DropAction QDropEvent::proposedAction() const
Devuelve la acción de eliminación propuesta.
Véase también dropAction().
void QDropEvent::setDropAction(Qt::DropAction action)
Establece la acción de « action » que el destino debe realizar con los datos. Utiliza esta opción para anular la acción predeterminada de « proposed action » y sustituirla por una de las opciones de « possible actions ».
Si se establece una acción de soltar que no sea una de las acciones posibles, la operación de arrastrar y soltar se convertirá, por defecto, en una operación de copiar.
Una vez que haya especificado una acción de soltar alternativa, llame a ` accept()` en lugar de ` 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 resulta útil si tu widget necesita un comportamiento especial al arrastrarse hacia sí mismo.
Véase también QDrag::QDrag().
[protected delete] QDropEvent &QDropEvent::operator=(QDropEvent &&)
Asigna « other » a esta instancia de « QDropEvent ». Esta función se elimina.
[noexcept protected default] QDropEvent &QDropEvent::operator=(const QDropEvent &other)
Asigna por copia other a esta instancia de QDropEvent.
© 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.