QDropEvent

La classe QDropEvent fournit un événement qui est envoyé lorsqu'une action de glisser-déposer se termine. Plus d'informations...

#include <QDropEvent>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QEvent et QMimeSource.

Hérité par QDragMoveEvent.

Description détaillée

La classe QDropEvent fournit un événement qui est envoyé lorsqu'une action de glisser-déposer se termine.

Lorsqu'un widget accepte les événements de dépose, il recevra cet événement s'il a accepté l'événement QDragEnterEvent ou QDragMoveEvent le plus récent qui lui a été envoyé.

L'événement de dépose contient une action proposée, accessible par proposedAction(), que le widget peut accepter ou ignorer. Si l'action peut être traité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 une de ces valeurs comme action par défaut ou de demander à l'utilisateur de sélectionner son action préférentielle.

Si l'action de dépose proposée ne convient pas, par exemple si votre widget personnalisé ne gère pas cette action, vous pouvez la remplacer par une des actions de dépose possibles en appelant setDropAction() avec l'action choisie. Si vous spécifiez une valeur qui n'est pas présente dans la combinaison de bits renvoyée par possibleActions(), l'action de copie par défaut sera utilisée. Après avoir fixé l'action de dépose de remplacement, appelez accept() au lieu de acceptProposedAction() pour terminer l'opération de dépose.

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 aussi QMimeData, QDrag et glisser-déposer.

Fonctions membres

QDropEvent::QDropEvent ( const QPoint & pos, Qt::DropActions actions, const QMimeData * data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Type type = Drop )

Construit un événement de dépose du type donné correspondant à une dépose au point spécifié par pos dans le système de coordonnées du widget destination.

Les actions indiquent quels types d'opérations de glisser-déposer peuvent être effectuées et les données associées sont stockées en encodage MIME dans data.

Les états des boutons de souris et les modificateurs de clavier au moment de la dépose sont spécifiés par buttons et modifiers.

void QDropEvent::acceptProposedAction ()

Accepte l'action proposée comme action de dépose.

Voir aussi setDropAction(), proposedAction() et accept().

Qt::DropAction QDropEvent::dropAction () const

Renvoie l'action qui doit être effectuée sur les données par la cible. Elle peut être différente de l'action spécifiée par proposedAction() si vous avez appelé setDropAction() pour choisir explicitement une action de dépose.

Voir aussi setDropAction().

Qt::KeyboardModifiers QDropEvent::keyboardModifiers () const

Renvoie les modificateurs de clavier actifs.

const QMimeData * QDropEvent::mimeData () const

Renvoie les données déposées sur le widget et l'information de type MIME associée.

Qt::MouseButtons QDropEvent::mouseButtons () const

Renvoie les boutons de souris appuyés.

const QPoint & QDropEvent::pos () const

Renvoie la position à laquelle la dépose a été faite.

Qt::DropActions QDropEvent::possibleActions () const

Renvoie une combinaison OU des actions de dépose possibles.

Voir aussi dropAction().

Qt::DropAction QDropEvent::proposedAction () const

Renvoie l'action de dépose proposée.

Voir aussi dropAction().

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

Définit l'action à effectuer sur les données par la cible. Utilisez cette fonction pour remplacer l'action proposée par une des actions possibles.

Si vous définissez une action de dépose qui ne fait pas partie des actions possibles, l'opération de glisser-déposer deviendra par défaut une action de copie.

Après avoir spécifié une action de remplacement, appelez accept() au lieu de acceptProposedAction().

Voir aussi dropAction().

QWidget * QDropEvent::source () const

Si la source de l'opération de glisser-déposer est un widget de l'application, la fonction renvoie cette source ; sinon elle renvoie 0. La source de l'opération est le premier paramètre de l'objet QDrag utilisé au début de l'opération.

Cette fonction est utile si votre widget doit se comporter différemment en cas de dépose sur lui-même.

Voir aussi QDrag::QDrag().

Remerciements

Merci à Ilya Diallo pour la traduction et à Jonathan Courtois, Claude Leloup et Jacques Thery pour leur relecture !