QGraphicsSceneDragDropEvent

La classe QGraphicsSceneDragDropEvent fournit les événements pour le glisser-déposer dans le framework de la Vue Graphique. Plus d'informations....

#include <QGraphicsSceneDragDropEvent>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QGraphicsSceneEvent.

Cette classe a été introduite dans Qt 4.2.

Description détaillée

La classe QGraphicsSceneDragDropEvent fournit les événements pour le glisser/déposer dans le framework de la Vue Graphique.

QGraphicsView hérite des fonctionnalités de glisser-déposer fournies par QWidget. Lorsqu'elle reçoit un événement de glisser-déposer, elle le transmet à un QGraphicsSceneDragDropEvent.

QGraphicsSceneDragDropEvent stocke les événements de type GraphicsSceneDragEnter, GraphicsSceneDragLeave, GraphicsSceneDragMove ou GraphicsSceneDrop.

QGraphicsSceneDragDropEvent contient la position du curseur de la souris dans les systèmes de coordonnées de l'élément, de la scène et de l'écran ; Elle peut être récupérée avec pos(), scenePos() et screenPos().

La scène émet l'événement au premier QGraphicsItem sous le curseur de la souris qui accepte les actions de déposer ; un item graphique gère l'acceptation des actions de déposer avec setAcceptDrops().

Fonctions membres

QGraphicsSceneDragDropEvent::~QGraphicsSceneDragDropEvent ()

Détruit l'objet.

void QGraphicsSceneDragDropEvent::acceptProposedAction ()

Définit l'action proposée comme acceptée, c'est-à-dire, l'action de déposer est activée pour l'action proposée. Ceci est équivalent à :

 setDropAction(proposedAction());

Lorsque vous utilisez cette fonction, il ne faut pas appeler accept().

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

Qt::MouseButtons QGraphicsSceneDragDropEvent::buttons () const

Retourne une valeur Qt::MouseButtons indiquant quels boutons ont été pressés sur la souris quand cet événement de souris a été généré.

Voir aussi Qt::MouseButtons.

Qt::DropAction QGraphicsSceneDragDropEvent::dropAction () const

Retourne l'action qui a été effectuée dans ce glisser-déposer. Celle-ci devrait être gérée par le destinataire du déposer et est retournée par QDrag::exec().

Voir aussi setDropAction() et acceptProposedAction().

const QMimeData * QGraphicsSceneDragDropEvent::mimeData () const

Cette fonction retourne les données MIME de l'événement.

Qt::KeyboardModifiers QGraphicsSceneDragDropEvent::modifiers () const

Retourne les modificateurs clavier qui ont été pressés lorsque l'événement de glisser-déposer a été créé.

Voir aussi Qt::KeyboardModifiers.

QPointF QGraphicsSceneDragDropEvent::pos () const

Retourne la position de la souris de l'événement par rapport à la vue qui a émis l'événement.

Voir aussi QGraphicsView, screenPos() et scenePos().

Qt::DropActions QGraphicsSceneDragDropEvent::possibleActions () const

Retourne les actions de déposer possibles que le glisser-déposer peut engendrer.

Voir aussi Qt::DropActions.

Qt::DropAction QGraphicsSceneDragDropEvent::proposedAction () const

Retourne l'action de déposer qui est proposée, c'est-à-dire, préférée. L'action doit être une des actions possibles comme définies par possibleActions().

Voir aussi Qt::DropAction et possibleActions().

QPointF QGraphicsSceneDragDropEvent::scenePos () const

Retourne la position de la souris dans le système de coordonnées de la scène.

Voir aussi pos() et screenPos().

QPoint QGraphicsSceneDragDropEvent::screenPos () const

Retourne la position de la souris par rapport à l'écran.

Voir aussi pos() et scenePos().

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

Cette fonction laisse le destinataire du déposer définir l'action de déposer qui a été réalisée par action, qui devrait être une des actions possibles. Appelez accept() au lieu de acceptProposedAction() si vous utilisez cette fonction.

Voir aussi dropAction(), accept() et possibleActions().

QWidget * QGraphicsSceneDragDropEvent::source () const

Cette fonction retourne la QGraphicsView qui a créé le QGraphicsSceneDragDropEvent.

Remerciements

Merci à Dimitry Ernot pour la traduction et à Jonathan Courtois ainsi qu'à Jacques Thery pour leur relecture !