QEvent

La classe QEvent est la classe de base de toutes les classes �v�nementielles. Les objets �v�nementiels contiennent des param�tres �v�nementiels. Plus d'informations...

#include <QEvent>

Voir la position dans l'arbre des classes.

H�ritage

H�rit� par QAccessibleEvent, QActionEvent, QChildEvent, QCloseEvent, QCustomEvent, QDragLeaveEvent, QDropEvent, QDynamicPropertyChangeEvent, QFileOpenEvent, QFocusEvent, QGestureEvent, QGraphicsSceneEvent, QHelpEvent, QHideEvent, QHoverEvent, QIconDragEvent, QInputEvent, QInputMethodEvent, QMoveEvent, QPaintEvent, QResizeEvent, QShortcutEvent, QShowEvent, QStatusTipEvent, QTimerEvent, QWhatsThisClickedEvent et QWindowStateChangeEvent.

Description d�taill�e

La classe QEvent est la classe de base de toutes les classes �v�nementielles. Les objets �v�nementiels contiennent des param�tres �v�nementiels.

La boucle �v�nementielle principale de Qt (QCoreApplication::exec()) r�cup�re les �v�nements du syst�me de fen�trage natif � partir de la file �v�nementielle, les traduit en QEvent et les envoie aux QObject.

En g�n�ral, les �v�nements proviennent du syst�me de fen�trage sous-jacent (spontaneous() retourne true), mais il est aussi possible d'envoyer manuellement les �v�nements � l'aide de QCoreApplication::sendEvent() et de QCoreApplication::postEvent() (spontaneous() retourne false).

Les QObjects re�oivent des �v�nements en ayant leur fonction QObject::event() appel�e. La fonction peut �tre r�impl�ment�e dans des sous-classes pour personnaliser la gestion �v�nementielle et ajouter d'autre types �v�nementiels ; QWidget::event() est un bon exemple. Par d�faut, les �v�nements sont envoy�s aux gestionnaires �v�nementiels comme QObject::timerEvent() et QWidget::mouseMoveEvent(). QObject::installEventFilter() permet d'intercepter les �v�nements destin�s � un objet pour un autre objet.

Le QEvent de base contient uniquement un param�tre de type �v�nementiel et un drapeau (flag) d'� acceptation �. Le drapeau d'acceptation s'active avec accept() et se d�sactive avec ignore(). Il est activ� par d�faut mais ne comptez pas dessus, car les sous-classes peuvent choisir de le d�sactiver dans leurs constructeurs.

Les sous-classes de QEvent contiennent des param�tres suppl�mentaires qui d�crivent l'�v�nement particulier.

Voir aussi QObject::event(), QObject::installEventFilter(), QWidget::event(), QCoreApplication::sendEvent(), QCoreApplication::postEvent() et QCoreApplication::processEvents().

Type

enum QEvent::Type

Ce type d'�num�ration d�finit les types �v�nementiels valides dans Qt. Les types �v�nementiels et les classes sp�cialis�es pour chaque type sont les suivants :

Les �v�nements utilisateurs devraient avoir des valeurs comprises entre User et MaxUser :

Pour plus de commodit�, vous pouvez utiliser la fonction registerEventType() pour enregistrer et r�server le type �v�nementiel personnalis� dans votre application. Cela vous permettra d'�viter de r�utiliser accidentellement un type �v�nementiel personnalis� d�j� utilis� ailleurs dans votre application.

Propri�t�

accepted : bool

Le drapeau accepted de l'objet �v�nementiel.

Le r�glage du param�tre accepted indique que le receveur �v�nementiel veut l'�v�nement. Les �v�nements non d�sir�s peuvent se propager au widget parent. Par d�faut, isAccepted() est d�fini � true mais ne vous fiez pas � lui, vu que les sous-classes peuvent choisir de l'infirmer dans leur constructeur.

Pour plus de commodit�, le drapeau accepted peut �galement �tre accept� avec accept() et d�sactiv� avec ignore().

Fonctions d'acc�s

bool isAccepted () const

void setAccepted ( bool accepted )

Fonctions membres

QEvent::QEvent ( Type type )

Construit un objet �v�nementiel du type type.

QEvent::~QEvent () [virtual]

D�truit l'�v�nement. S'il a �t� envoy�, il sera retir� de la liste des �v�nements � poster.

void QEvent::accept ()

Active le drapeau accepted de l'objet �v�nementiel, l'�quivalent d'un appel � setAccepted(true).

Activer le param�tre accepted indique que le r�cepteur de l'�v�nement souhaite le traiter. Les �v�nements non d�sir�s peuvent �tre propag�s au widget parent.

Voir aussi ignore().

void QEvent::ignore ()

D�sactive le drapeau accepted de l?objet �v�nementiel, l?�quivalent d'un appel � setAccepted(false).

D�sactiver le param�tre accepted indique que le r�cepteur �v�nementiel refuse l'�v�nement. Les �v�nements non d�sir�s peuvent �tre propag�s au widget parent.

Voir aussi accept().

int QEvent::registerEventType ( int hint = -1 ) [static]

Enregistre et retourne le type de l'�v�nement personnalis�. L'indice hint fourni sera utilis� s'il est disponible, sinon une valeur comprise entre QEvent::User et QEvent::MaxUser qui n'a pas encore �t� enregistr�e sera renvoy�e. L'indice est ignor� si sa valeur n'est pas comprise entre QEvent::User et QEvent::MaxUser.

Note : cette fonction est thread-safe.

Cette fonction a �t� introduite dans Qt 4.4.

bool QEvent::spontaneous () const

Retourne true si l'�v�nement provient de l'ext�rieur de l'application (un �v�nement syst�me), sinon retourne false.

La valeur de retour de cette fonction n'est pas d�finie pour les �v�nements de peinture.

Type QEvent::type () const

Retourne le type �v�nementiel.

Remerciements

Merci � Abdelhafid Hafidi pour la traduction, � Thibaut Cuvelier pour la traduction et la relecture ainsi qu'� Jonathan Courtois et Maxime Gault pour la relecture !