Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

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>
  
  

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 QObject 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 :

Constante Valeur Description
QEvent::None   N'est pas un �v�nement.
QEvent::AccessibilityDescription 130 Utilis� pour demander les textes descriptifs pour l'accessibilit� (QAccessibleEvent).
QEvent::AccessibilityHelp 119 Utilis� pour demander les textes d'aide pour l'accessibilit� (QAccessibleEvent).
QEvent::AccessibilityPrepare 86 Les informations sur l'accessibilit� sont demand�es.
QEvent::ActionAdded 114 Une nouvelle action a �t� ajout�e (QActionEvent).
QEvent::ActionChanged 113 Une action a �t� chang�e (QActionEvent).
QEvent::ActionRemoved 115 Une action a �t� supprim�e (QActionEvent).
QEvent::ActivationChange 99 L'activation de la fen�tre du widget de haut-niveau a chang�.
QEvent::ApplicationActivate 121 L'application a �t� mise � la disposition de l'utilisateur.
QEvent::ApplicationActivated ApplicationActivate Cette �num�ration a �t� d�pr�ci�e. Pr�f�rer ApplicationActivate.
QEvent::ApplicationDeactivate 122 L'application a �t� suspendue et est indisponible pour l'utilisateur.
QEvent::ApplicationFontChange 36 La police par d�faut de l'application a chang�.
QEvent::ApplicationLayoutDirectionChange 37 Le layout par d�faut de l'application a chang�.
QEvent::ApplicationPaletteChange 38 La palette par d�faut de l'application a chang�.
QEvent::ApplicationWindowIconChange 35 L'ic�ne de l'application a chang�.
QEvent::ChildAdded 68 Un objet gagne un enfant (QChildEvent).
QEvent::ChildInserted 70 Un objet gagne un enfant (QChildEvent). Uniquement Qt3Support. Pr�f�rer ChildAdded.
QEvent::ChildPolished 69 Un widget enfant a �t� poli (QChildEvent).
QEvent::ChildRemoved 71 Un objet perd un enfant (QChildEvent).
QEvent::Clipboard 40 Le contenu du presse-papier a chang� (QClipboardEvent).
QEvent::Close 19 Le widget a �t� ferm� (QCloseEvent).
QEvent::CloseSoftwareInputPanel 200 Un widget veut fermer le panneau d'entr�e logicielle (SIP, software input panel).
QEvent::ContentsRectChange 178 Les marges du rectangle du contenu du widget ont chang�.
QEvent::ContextMenu 82 Menu contextuel surgissant (QContextMenuEvent).
QEvent::CursorChange 183 Le curseur du widget a chang�.
QEvent::DeferredDelete 52 L'objet sera supprim� apr�s avoir �t� nettoy�.
QEvent::DragEnter 60 Le curseur entre dans un widget pendant une op�ration de glisser-d�poser (QDragEnterEvent).
QEvent::DragLeave 62 Le curseur quitte un widget pendant une op�ration de glisser-d�poser (QDragLeaveEvent).
QEvent::DragMove 61 Une op�ration de glisser-d�poser est en cours (QDragMoveEvent).
QEvent::Drop 63 Une op�ration de glisser-d�poser est achev�e (QDropEvent).
QEvent::EnabledChange 98 L'�tat d'activation du widget a chang�.
QEvent::Enter 10 La souris entre dans les limites du widget.
QEvent::EnterEditFocus 150 Un widget �diteur gagne le focus pour l'�dition.
QEvent::EnterWhatsThisMode 124 Envoie aux widgets de plus haut niveau le moment o� l'application entre dans le mode « What's This? ».
QEvent::FileOpen 116 Requ�te d'ouverture de fichier (QFileOpenEvent).
QEvent::FocusIn 8 Le widget gagne le focus du clavier (QFocusEvent).
QEvent::FocusOut 9 Le widget perd le focus du clavier (QFocusEvent).
QEvent::FontChange 97 La police du widget a chang�.
QEvent::GrabKeyboard 188 L'item gagne la saisie du clavier (uniquement QGraphicsItem).
QEvent::GrabMouse 186 L'item gagne la saisie de la souris (uniquement QGraphicsItem).
QEvent::GraphicsSceneContextMenu 159 Le menu contextuel surgissant survole une QGraphicsScene (QGraphicsSceneContextMenuEvent).
QEvent::GraphicsSceneDragEnter 164 Le curseur entre dans une QGraphicsScene pendant une op�ration de glisser-d�poser (QGraphicsSceneDragDropEvent).
QEvent::GraphicsSceneDragLeave 166 Le curseur sort d'une QGraphicsScene pendant une op�ration de glisser-d�poser (QGraphicsSceneDragDropEvent).
QEvent::GraphicsSceneDragMove 165 Une op�ration de glisser-d�poser est en cours sur une QGraphicsScene (QGraphicsSceneDragDropEvent).
QEvent::GraphicsSceneDrop 167 Une op�ration de glisser-d�poser est achev�e sur une QGraphicsScene (QGraphicsSceneDragDropEvent).
QEvent::GraphicsSceneHelp 163 L'utilisateur demande de l'aide pour une QGraphicsScene (QHelpEvent).
QEvent::GraphicsSceneHoverEnter 160 Le curseur de la souris entre dans un item planant dans une QGraphicsScene (QGraphicsSceneHoverEvent).
QEvent::GraphicsSceneHoverLeave 162 Le curseur de la souris sort d'un item planant dans une QGraphicsScene (QGraphicsSceneHoverEvent).
QEvent::GraphicsSceneHoverMove 161 Le curseur de la souris bouge dans un item planant dans une QGraphicsScene (QGraphicsSceneHoverEvent).
QEvent::GraphicsSceneMouseDoubleClick 158 La souris est press�e encore une fois (double clic) dans une QGraphicsScene (QGraphicsSceneMouseEvent).
QEvent::GraphicsSceneMouseMove 155 La souris est dans une QGraphicsScene (QGraphicsSceneMouseEvent).
QEvent::GraphicsSceneMousePress 156 La souris est press�e dans une QGraphicsScene (QGraphicsSceneMouseEvent).
QEvent::GraphicsSceneMouseRelease 157 La souris est rel�ch�e dans une QGraphicsScene (QGraphicsSceneMouseEvent).
QEvent::GraphicsSceneMove 182 Le widget a �t� d�plac� (QGraphicsSceneMoveEvent).
QEvent::GraphicsSceneResize 181 Le widget a �t� redimensionn� (QGraphicsSceneResizeEvent).
QEvent::GraphicsSceneWheel 168 La roulette de la souris a �t� utilis�e dans une QGraphicsScene (QGraphicsSceneWheelEvent).
QEvent::Hide 18 Le widget a �t� cach� (QHideEvent).
QEvent::HideToParent 27 Un widget enfant a �t� cach�.
QEvent::HoverEnter 127 Le curseur de la souris entre dans un widget planant (QHoverEvent).
QEvent::HoverLeave 128 Le curseur de la souris sort d'un widget planant (QHoverEvent).
QEvent::HoverMove 129 Le curseur de la souris se d�place dans un widget planant (QHoverEvent).
QEvent::IconDrag 96 L'ic�ne principale d'une fen�tre a �t� d�pos�e au loin (QIconDragEvent).
QEvent::IconTextChange 101 Le texte de l'ic�ne du widget a �t� chang�.
QEvent::InputMethod 83 Une m�thode de saisie est utilis�e (QInputMethodEvent).
QEvent::KeyPress 6 Une touche a �t� press�e (QKeyEvent).
QEvent::KeyRelease 7 Une touche a �t� rel�ch�e (QKeyEvent).
QEvent::LanguageChange 89 La traduction de l'application a �t� chang�e.
QEvent::LayoutDirectionChange 90 La direction des layouts a chang�.
QEvent::LayoutRequest 76 Le layout du widget doit �tre refait.
QEvent::Leave 11 La souris quitte les fronti�res du widget.
QEvent::LeaveEditFocus 151 Un widget d'�dition perd le focus.
QEvent::LeaveWhatsThisMode 125 Envoie aux widgets de plus haut niveau le moment o� l'application sort du mode « What's This? ».
QEvent::LocaleChange 88 La locale du syst�me a chang�.
QEvent::NonClientAreaMouseButtonDblClick 176 Un double clic de la souris a eu lieu en dehors de la zone cliente.
QEvent::NonClientAreaMouseButtonPress 174 Un bouton de la souris a �t� enfonc� en dehors de la zone cliente.
QEvent::NonClientAreaMouseButtonRelease 175 Un bouton de la souris a �t� rel�ch� en dehors de la zone cliente.
QEvent::NonClientAreaMouseMove 173 Un mouvement de la souris a eu lieu en dehors de la zone cliente.
QEvent::MacSizeChange 177 L'utilisateur a chang� la taille de ses widgets (uniquement sous Mac OS X).
QEvent::MenubarUpdated 153 La barre de menus de la fen�tre a �t� mise � jour.
QEvent::MetaCall 43 Une m�thode d'invocation asynchrone via QMetaObject::invokeMethod().
QEvent::ModifiedChange 102 L'�tat de modification des widgets a �t� chang�.
QEvent::MouseButtonDblClick 4 La souris a �t� � nouveau press�e (QMouseEvent).
QEvent::MouseButtonPress 2 La souris a �t� press�e (QMouseEvent).
QEvent::MouseButtonRelease 3 La souris a �t� rel�ch�e (QMouseEvent).
QEvent::MouseMove 5 La souris a �t� d�plac�e (QMouseEvent).
QEvent::MouseTrackingChange 109 L'�tat du suivi de la souris a chang�.
QEvent::Move 13 La position du widget a chang� (QMoveEvent).
QEvent::Paint 12 Mise � jour de l'�cran n�cessaire (QPaintEvent).
QEvent::PaletteChange 39 La palette du widget a chang�.
QEvent::ParentAboutToChange 131 Le widget parent est sur le point de changer.
QEvent::ParentChange 21 Le widget parent a chang�.
QEvent::Polish 75 Le widget est poli.
QEvent::PolishRequest 74 Le widget devrait �tre poli.
QEvent::QueryWhatsThis 123 Le widget devrait accepter cet �v�nement s'il a une aide « What's This? ».
QEvent::RequestSoftwareInputPanel 199 Un widget veut ouvrir un paneau d'entr�e logicielle (SIP, software input panel).
QEvent::Resize 14 La taille du widget a chang� (QResizeEvent).
QEvent::Shortcut 117 Touche enfonc�e dans un widget enfant pour la prise en charge des raccourcis clavier (QShortcutEvent).
QEvent::ShortcutOverride 51 Touche enfonc�e dans un widget enfant, pour surcharger la prise en charge des raccourcis clavier (QKeyEvent).
QEvent::Show 17 Le widget a �t� affich� � l'�cran (QShowEvent).
QEvent::ShowToParent 26 Un widget enfant a �t� expos�.
QEvent::SockAct 50 Socket activ�, utiliser l'impl�mentation QSocketNotifier.
QEvent::StateMachineSignal 192 Un signal qui doit �tre d�livr� � une machine � �tat (QStateMachine::SignalEvent).
QEvent::StateMachineWrapped 193 L'�v�nement est un wrapper pour (contient) un autre �v�nement (QStateMachine::WrappedEvent).
QEvent::StatusTip 112 Un indice sur l'�tat est demand� (QStatusTipEvent).
QEvent::StyleChange 100 Le style du widget a �t� chang�.
QEvent::TabletMove 87 La tablette Wacom a �t� d�plac�e (QTabletEvent).
QEvent::TabletPress 92 La tablette Wacom a �t� press�e (QTabletEvent).
QEvent::TabletRelease 93 La tablette Wacom a �t� rel�ch�e (QTabletEvent).
QEvent::OkRequest 94 La d�coration du bouton OK a �t� press�e. Pris en charge uniquement sous Windows CE.
QEvent::TabletEnterProximity 171 La tablette Wacom entre dans un �v�nement de proximit� (QTabletEvent), envoy� � QApplication.
QEvent::TabletLeaveProximity 172 La tablette Wacom quitte un �v�nement de proximit� (QTabletEvent), envoy� � QApplication.
QEvent::Timer 1 �v�nements ordinaires de minuterie (QTimerEvent).
QEvent::ToolBarChange 120 Le bouton de la barre d'outil est bascul� sur Mac OS X.
QEvent::ToolTip 110 Une bo�te d'aide a �t� demand�e (QHelpEvent).
QEvent::ToolTipChange 184 La bo�te d'aide du widget a chang�.
QEvent::UngrabKeyboard 189 L'item perd la saisie du clavier (uniquement QGraphicsItem).
QEvent::UngrabMouse 187 L'item perd la saisie de la souris (uniquement QGraphicsItem).
QEvent::UpdateLater 78 Le widget devrait �tre mis dans la queue pour �tre repeint plus tard.
QEvent::UpdateRequest 77 Le widget doit �tre repeint.
QEvent::WhatsThis 111 Le widget devrait montrer son aide « What's This? » (QHelpEvent).
QEvent::WhatsThisClicked 118 Un lien dans l'aide « What's This? » d'un widget a �t� cliqu�.
QEvent::Wheel 31 La roulette de la souris a �t� utilis�e (QWheelEvent).
QEvent::WinEventAct 132 Un �v�nement d'activation sp�cifique a Windows a eu lieu.
QEvent::WindowActivate 24 La fen�tre a �t� activ�e.
QEvent::WindowBlocked 103 La fen�tre est bloqu�e par une bo�te de dialogue.
QEvent::WindowDeactivate 25 La fen�tre a �t� d�sactiv�e.
QEvent::WindowIconChange 34 L'ic�ne de la fen�tre a chang�.
QEvent::WindowStateChange 105 L'�tat de la fen�tre(r�duit, agrandit ou plein �cran) a chang�. (QWindowStateChangeEvent).
QEvent::WindowTitleChange 33 Le titre de la fen�tre a chang�.
QEvent::WindowUnblocked 104 La fen�tre est d�bloqu�e apr�s la sortie d'une bo�te de dialogue modale.
QEvent::ZOrderChange 126 Le z-order du widget a chang�. L'�v�nement n'est jamais envoy� � une fen�tre de haut niveau.
QEvent::KeyboardLayoutChange 169 La disposition du clavier a chang�.
QEvent::DynamicPropertyChange 170 Une propri�t� dynamique a �t� ajout�e, chang�e ou enlev�e de l'objet.
QEvent::TouchBegin 194 D�but d'une s�quence d'�v�nements de toucher sur �cran et/ou de track-pad (QTouchEvent).
QEvent::TouchUpdate 195 �v�nement tactile (QTouchEvent).
QEvent::TouchEnd 196 Fin de la s�quence tactile (QTouchEvent).
QEvent::WinIdChange 203 L'identifiant du syst�me de fen�trage pour ce widget natif a chang�.
QEvent::Gesture 198 Un geste a eu lieu (QGestureEvent).
QEvent::GestureOverride 202 Un remplacement de geste a eu lieu (QGestureEvent).

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

Constante Valeur Description
QEvent::User 1000 �v�nement d�fini par l'utilisateur.
QEvent::MaxUser 65535 Dernier identifiant �v�nementiel utilisateur.

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().

Fonction 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 !

Publicit�

Best Of

Actualit�s les plus lues

Semaine
Mois
Ann�e
  1. Microsoft ouvre aux autres compilateurs C++ AMP, la sp�cification pour la conception d'applications parall�les C++ utilisant le GPU 22
  2. Les d�veloppeurs ignorent-ils trop les failles d�couvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  3. RIM : � 13 % des d�veloppeurs ont gagn� plus de 100 000 $ sur l'AppWord �, Qt et open-source au menu du BlackBerry DevCon Europe 0
  4. � Quelque chose ne va vraiment pas avec les d�veloppeurs "modernes" �, un d�veloppeur � "l'ancienne" critique la multiplication des biblioth�ques 10
  5. BlackBerry 10 : premi�res images du prochain OS de RIM qui devrait int�grer des widgets et des tuiles inspir�es de Windows Phone 0
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil d�claratif et extensible pour la compilation de projets Qt 17
  7. Quelles nouveaut�s de C++11 Visual C++ doit-il rapidement int�grer ? Donnez-nous votre avis 10
Page suivante

Le Qt Quarterly au hasard

Logo

D�ployer dans le Bazaar

Qt Quarterly est la revue trimestrielle propos�e par Nokia et � destination des d�veloppeurs Qt. Ces articles d'une grande qualit� technique sont r�dig�s par des experts Qt. Lire l'article.

Communaut�

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la r�daction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, �crite par Nokia Corporation and/or its subsidiary(-ies). Les �ventuels probl�mes r�sultant d'une mauvaise traduction ne sont pas imputables � Nokia. Qt 4.6
Copyright © 2012 Developpez LLC. Tous droits r�serv�s Developpez LLC. Aucune reproduction, m�me partielle, ne peut �tre faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'� 3 ans de prison et jusqu'� 300 000 E de dommages et int�r�ts. Cette page est d�pos�e � la SACD.
Vous avez d�nich� une erreur ? Un bug ? Une redirection cass�e ? Ou tout autre probl�me, quel qu'il soit ? Ou bien vous d�sirez participer � ce projet de traduction ? N'h�sitez pas � nous contacter ou par MP !
 
 
 
 
Partenaires

H�bergement Web