QDropEvent Class
La classe QDropEvent fournit un événement qui est envoyé lorsqu'une action de glisser-déposer est terminée. Plus d'informations...
| En-tête : | #include <QDropEvent> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite : | QEvent |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- les membres dépréciés
- QDropEvent fait partie des classes d'événements.
Fonctions publiques
| 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 |
Description détaillée
Lorsqu'un widget accepts drop events, il recevra cet événement s'il a accepté le dernier QDragEnterEvent ou QDragMoveEvent qui lui a été envoyé.
L'événement drop contient une proposition d'action, disponible sur proposedAction(), que le widget peut accepter ou ignorer. Si l'action peut être gérée par le widget, vous devez appeler la fonction acceptProposedAction(). Étant donné que l'action proposée peut être une combinaison de valeurs Qt::DropAction, il peut être utile de sélectionner l'une de ces valeurs comme action par défaut ou de demander à l'utilisateur de choisir l'action qu'il préfère.
Si l'action de dépôt proposée ne convient pas, peut-être parce que votre widget personnalisé ne prend pas en charge cette action, vous pouvez la remplacer par l'une des valeurs possible drop actions en appelant setDropAction() avec l'action de votre choix. Si vous définissez une valeur qui n'est pas présente dans la combinaison OU binaire des valeurs renvoyées par possibleActions(), l'action de copie par défaut sera utilisée. Une fois qu'une action de dépôt de remplacement a été définie, appelez accept() au lieu de acceptProposedAction() pour terminer l'opération de dépôt.
La fonction mimeData() fournit les données déposées sur le widget dans un objet QMimeData. Cet objet contient des informations sur le type MIME des données en plus des données elles-mêmes.
Voir également QMimeData, QDrag, et Drag and Drop.
Documentation des fonctions membres
QDropEvent::QDropEvent(const QPointF &pos, Qt::DropActions actions, const QMimeData *data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, QEvent::Type type = Drop)
Construit un événement de dépôt d'un certain type correspondant à un dépôt au point spécifié par pos dans le système de coordonnées du widget de destination.
Les actions indiquent quels types d'opérations de glisser-déposer peuvent être effectués, et les données de glisser-déposer sont stockées sous forme de données codées MIME dans data.
Les états des boutons de la souris et des modificateurs du clavier au moment du dépôt sont spécifiés par buttons et modifiers.
void QDropEvent::acceptProposedAction()
Définit l'action de dépôt comme étant l'action proposée.
Voir également setDropAction(), proposedAction() et accept().
[since 6.0] Qt::MouseButtons QDropEvent::buttons() const
Renvoie les boutons de la souris qui sont enfoncés.
Cette fonction a été introduite dans Qt 6.0.
Qt::DropAction QDropEvent::dropAction() const
Renvoie l'action à effectuer sur les données par la cible. Cette action peut être différente de celle fournie dans proposedAction() si vous avez appelé setDropAction() pour choisir explicitement une action de dépôt.
Voir aussi setDropAction().
const QMimeData *QDropEvent::mimeData() const
Renvoie les données qui ont été déposées sur le widget et les informations de type MIME qui y sont associées.
[since 6.0] Qt::KeyboardModifiers QDropEvent::modifiers() const
Renvoie les touches de modification pressées.
Cette fonction a été introduite dans Qt 6.0.
[since 6.0] QPointF QDropEvent::position() const
Renvoie la position où la chute a été effectuée.
Cette fonction a été introduite dans Qt 6.0.
Qt::DropActions QDropEvent::possibleActions() const
Renvoie une combinaison OU d'actions de dépôt possibles.
Voir aussi dropAction().
Qt::DropAction QDropEvent::proposedAction() const
Renvoie l'action de dépôt proposée.
Voir aussi dropAction().
void QDropEvent::setDropAction(Qt::DropAction action)
Définit le action qui doit être exécuté sur les données par la cible. Utilisez cette option pour remplacer l'action proposed action par l'une des actions possible actions.
Si vous définissez une action de dépôt qui ne fait pas partie des actions possibles, l'opération de glisser-déposer sera par défaut une opération de copie.
Une fois que vous avez fourni une action de dépôt de remplacement, appelez accept() au lieu de acceptProposedAction().
Voir également dropAction().
QObject *QDropEvent::source() const
Si la source de l'opération de glissement est un widget de cette application, cette fonction renvoie cette source ; sinon, elle renvoie nullptr. La source de l'opération est le premier paramètre de l'objet QDrag utilisé pour instancier le glisser.
Cette fonction est utile si votre widget a besoin d'un comportement spécial lorsqu'il se glisse sur lui-même.
Voir également 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.
