QDragMoveEvent

La classe QDragMoveEvent fournit un événement qui est envoyé pendant les actions de glisser-déposer. Plus d'informations...

#include <QDragMoveEvent>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QDropEvent.

Hérité par QDragEnterEvent.

Description détaillée

La classe QDragMoveEvent fournit un événement qui est envoyé pendant les actions de glisser-déposer.

Un widget reçoit une succession d'événements de déplacement pendant que le glissement se fait à l'intérieur de ses frontières, à condition qu'il accepte les événements de dépôt et les événements de début de glissement. Le widget doit examiner les événements pour vérifier quel type de données il fournit et appeler la fonction accept() pour accepter éventuellement le dépôt.

Le rectangle donné par la fonction answerRect() peut être utilisé pour restreindre la dépose à certaines parties du widget. Par exemple, on peut vérifier si le rectangle a une intersection avec la géométrie d'un widget enfant particulier et n'appeler acceptProposedAction() que si c'est le cas.

Notez que la plus grande partie des fonctionnalités de cette classe hérite de QDropEvent.

Voir aussi QDragEnterEvent, QDragLeaveEvent et QDropEvent.

Fonctions membres

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

Crée un QDragMoveEvent du type demandé indiquant que la souris se trouve à la position pos dans un widget.

Les états souris et clavier sont spécifiés par buttons et modifiers, et actions décrit les opérations de glisser-déposer possibles. Les données sont transmises sous forme d'informations en encodage MIME dans data.

Attention : n'essayez pas de créer un QDragMoveEvent vous-même. Ces objets sont dépendants de l'état interne de Qt.

QDragMoveEvent::~QDragMoveEvent ()

Détruit l'événement.

void QDragMoveEvent::accept ( const QRect & rectangle )

Identique à accept() mais notifie également que de futurs événements seront aussi acceptables s'ils restent à l'intérieur du rectangle donné sur le widget. Cela peut améliorer les performances mais peut aussi être ignoré par le système sous-jacent.

Si le rectangle est vide, les événements de glissement vont être envoyés en continu, ce qui peut être utile si la source défile dans un événement timer.

void QDragMoveEvent::accept ()

Il s'agit d'une fonction surchargée.

Appelle QDropEvent::accept().

QRect QDragMoveEvent::answerRect () const

Renvoie le rectangle à l'intérieur du widget où le dépôt se produira si elle est acceptée. Vous pouvez utiliser cette information pour le restreindre à des endroits déterminés du widget.

void QDragMoveEvent::ignore ( const QRect & rectangle )

L'opposé de la fonction accept(const QRect&). Les déplacements dans rectangle seront ignorés.

void QDragMoveEvent::ignore ()

Il s'agit d'une fonction surchargée.

Appelle QDropEvent::ignore().

Remerciements

Merci à Ilya Diallo pour la traduction ainsi qu'à Thibaut Cuvelier et Maxime Gault pour leur relecture !