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 !