QDropEvent Class
La classe QDropEvent fournit un événement qui est déclenché lorsqu'une action de glisser-déposer est terminée. En savoir plus...
| En-tête : | #include <QDropEvent> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite de : | QEvent |
| Hérité par : |
- Liste de tous les membres, y compris les membres hérités
- Membres obsolètes
- 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 |
Fonctions protégées
| QDropEvent(QDropEvent &&) | |
| QDropEvent & | operator=(QDropEvent &&) |
| QDropEvent & | operator=(const QDropEvent &other) |
Description détaillée
Lorsqu'un widget accepts drop events, il reçoit cet événement s'il a accepté la dernière requête d'QDragEnterEvent ou QDragMoveEvent qui lui a été envoyée.
L'événement « drop » contient une action proposée, accessible via la fonction proposedAction(), que le widget peut soit accepter, soit 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 soit de sélectionner l’une de ces valeurs comme action par défaut, soit 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 de ` 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 par 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. Celui-ci contient des informations sur le type MIME des données en plus des données elles-mêmes.
Voir également QMimeData, QDrag et Glisser-déposer.
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)
Crée un événement de dépôt d'une certaine « type », correspondant à un dépôt au point spécifié par « pos » dans le système de coordonnées du widget de destination.
L'actions indique les types d'opérations de glisser-déposer pouvant être effectuées, et les données de glisser-déposer sont stockées sous forme de données encodées MIME dans data.
Les états des boutons de souris et des modificateurs du clavier au moment du dépôt sont spécifiés par buttons et modifiers.
[protected delete] QDropEvent::QDropEvent(QDropEvent &&)
Crée par « move » une instance de ` QDropEvent`. Cette fonction est supprimée.
void QDropEvent::acceptProposedAction()
Définit l'action par glisser-déposer comme étant l'action proposée.
Voir également setDropAction(), proposedAction() et accept().
[since 6.0] Qt::MouseButtons QDropEvent::buttons() const
Renvoie les boutons de souris qui sont enfoncés.
Cette fonction a été introduite dans Qt 6.0.
Qt::DropAction QDropEvent::dropAction() const
Renvoie l'action que la cible doit effectuer sur les données. Celle-ci peut différer de l'action fournie dans ` proposedAction()` si vous avez appelé ` setDropAction()` pour choisir explicitement une action de dépose.
Voir également setDropAction().
const QMimeData *QDropEvent::mimeData() const
Renvoie les données déposées sur le widget ainsi que les informations relatives à leur type MIME.
[since 6.0] Qt::KeyboardModifiers QDropEvent::modifiers() const
Renvoie les touches de modification qui sont enfoncées.
Cette fonction a été introduite dans Qt 6.0.
[since 6.0] QPointF QDropEvent::position() const
Renvoie la position à laquelle le dépôt a été effectué.
Cette fonction a été introduite dans Qt 6.0.
Qt::DropActions QDropEvent::possibleActions() const
Renvoie une combinaison « OU » des actions de suppression possibles.
Voir également dropAction().
Qt::DropAction QDropEvent::proposedAction() const
Renvoie l'action de suppression proposée.
Voir également dropAction().
void QDropEvent::setDropAction(Qt::DropAction action)
Définit l'action ion à appliquer aux données par la cible. Utilisez cette option pour remplacer l'proposed action ion par l'une des possible actions.
Si vous définissez une action de dépôt qui ne figure pas parmi les actions possibles, l’opération de glisser-déposer se transformera par défaut en 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 glisser-déposer 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-déposer.
Cela s’avère utile si votre widget nécessite un comportement particulier lorsqu’il est glissé vers lui-même.
Voir également QDrag::QDrag().
[protected delete] QDropEvent &QDropEvent::operator=(QDropEvent &&)
La commande « Move » affecte « other » à cette instance « QDropEvent ». Cette fonction est supprimée.
[noexcept protected default] QDropEvent &QDropEvent::operator=(const QDropEvent &other)
Copie et attribue other à cette instance 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.
