QKeyEvent

La classe QKeyEvent d�crit un �v�nement clavier. Plus d'informations...

#include <QKeyEvent>

Voir la position dans l'arbre des classes.

H�ritage

H�rite de QInputEvent.

Description d�taill�e

La classe QKeyEvent d�crit un �v�nement clavier.

Les �v�nements clavier sont envoy�s au widget ayant le focus de l'entr�e clavier lorsque les touches sont press�es ou rel�ch�es.

Un �v�nement clavier contient un drapeau (flag) sp�cial de validation qui indique si le receveur va g�rer ou non l'�v�nement clavier. Il est n�cessaire d'appeler ignore() si l'�v�nement d'enfoncement ou de rel�chement de touche n'est pas g�r� par le widget. Un �v�nement clavier remonte la chaine des widgets parents jusqu'� ce qu'un widget l'accepte avec accept() ou qu'un filtre d'�v�nements le consomme. Les �v�nements claviers pour les touches multim�dia sont ignor�s par d�faut. Il est n�cessaire d'appeler accept() si le widget g�re ces �v�nements.

La fonction QWidget::setEnable() peut �tre utilis�e pour activer ou d�sactiver les �v�nements de souris et de clavier pour un widget.

Les gestionnaires d'�v�nements QWidget::keyPressEvent(), QWidget::keyReleaseEvent(), QGraphicsItem::keyPressEvent() et QGraphicsItem::keyReleaseEvent() re�oivent les �v�nements clavier.

Voir aussi QFocusEvent et QWidget::grabKeyboard().

Fonctions membres

QKeyEvent::QKeyEvent ( Type type, int key, Qt::KeyboardModifiers modifiers, const QString & text = QString(), bool autorep = false, ushort count = 1 )

Construit un objet d'�v�nement clavier.

Le param�tre type doit �tre d�fini � QEvent::KeyPress, QEvent::KeyRelease ou bien � QEvent::ShortcutOverride.

L'entier key est le code pour la Qt::Key que la boucle d'�v�nement doit �couter. Si key vaut 0, l'�v�nement n'est pas le r�sultat d'une touche connue ; par exemple, il peut �tre le r�sultat d'une combinaison de touches ou d'une macro de clavier. Les modifiers gardent les modificateurs de clavier et le text donn� est le texte Unicode que le clavier a g�n�r�. Si autorep est � true, [qkeyevent#isAutoRepeat|isAutoRepeat()]] renverra true. count est le nombre de touches impliqu�es dans l'�v�nement.

int QKeyEvent::count () const

Retourne le nombre de touches impliqu�es dans cet �v�nement. Si text() n'est pas vide, cela retourne simplement la longueur de la chaine.

Voir aussi Qt::WA_KeyCompression.

bool QKeyEvent::isAutoRepeat () const

Retourne true si cet �v�nement provient d'une touche s'auto-r�p�tant ; retourne false si cela provient de l'appui initial sur une touche.

Notez que si l'�v�nement est un �v�nement qui concerne de multiples touches et qui est partiellement d� � l'auto-r�p�tition, cette fonction peut retourner de mani�re ind�termin�e true ou false.

int QKeyEvent::key () const

Retourne le code de la touche qui a �t� enfonc�e ou rel�ch�e.

Voir Qt::Key pour la liste des codes claviers. Ces codes sont ind�pendants du syst�me de fen�trage sous-jacent. Notez que cette fonction ne fait pas la distinction entre les lettres majuscules et minuscules ; utilisez la fonction text() (retournant le texte Unicode que la touche a g�n�r�) pour cela.

Une valeur de 0 ou de Qt::Key_unknown signifie que l'�v�nement n'est pas le r�sultat d'une touche connue ; par exemple, il peut r�sulter d'une composition de touches, d'une macro de clavier ou �tre d� � une composition d'�v�nements clavier.

Voir aussi Qt::WA_KeyCompression.

bool QKeyEvent::matches ( QKeySequence::StandardKey key ) const

Retourne true si l'�v�nement clavier correspond � la touche standard key ; sinon, retourne false.

Cette fonction a �t� introduite dans Qt 4.2.

Qt::KeyboardModifiers QKeyEvent::modifiers () const

Retourne les drapeaux de modificateurs clavier qui existaient imm�diatement apr�s que l'�v�nement s'est produit.

Attention : cette fonction n'est pas toujours fiable. L'utilisateur peut rendre confuse la valeur, par exemple en pressant les deux touches Shift simultan�ment et en rel�chant l'une d'entre elles.

Voir aussi QApplication::keyboardModifiers().

quint32 QKeyEvent::nativeModifiers () const

Retourne les modificateurs natifs d'un �v�nement clavier. Si l'�v�nement clavier ne contient pas cette donn�e, 0 est retourn�.

Note : les modificateurs natifs peuvent �tre 0 m�me si l'�v�nement clavier contient des informations �tendues.

Cette fonction a �t� introduite dans Qt 4.2.

quint32 QKeyEvent::nativeScanCode () const

Retourne le code d'analyse natif de l'�v�nement clavier. Si l'�v�nement clavier ne contient pas cette donn�e, 0 est retourn�.

Note : le code d'analyse natif peut �tre 0 m�me si l'�v�nement clavier contient des informations �tendues.

Note : sous Mac OS/X, cette fonction n'est pas utile parce qu'il n'y a pas de moyen d'obtenir le code d'analyse depuis Carbon ou Cocoa. Cette fonction y retourne toujours 1 (ou 0 dans le cas expliqu� ci-dessus).

Cette fonction a �t� introduite dans Qt 4.2.

quint32 QKeyEvent::nativeVirtualKey () const

Retourne la touche virtuelle native ou symbole de l'�v�nement clavier. Si l'�v�nement ne contient pas cette donn�e, 0 est retourn�.

Note : la touche virtuelle peut �tre 0 m�me si l'�v�nement clavier contient des informations �tendues.

Cette fonction a �t� introduite dans Qt 4.2.

QString QKeyEvent::text () const

Retourne le texte Unicode que cette touche a g�n�r�. Le texte retourn� peut �tre une chaine vide dans le cas o� les modificateurs de touches comme Shift, Control, Alt ou Meta, sont enfonc�s ou rel�ch�s. Dans les autres cas, key() contiendra une valeur valide.

Voir aussi Qt::WA_KeyCompression.

En relation mais non membres de la classe

bool operator== ( QKeyEvent * e, QKeySequence::StandardKey key )

Retourne true si key est actuellement li�e � la combinaison de touches sp�cifi�e par e.

�quivalent � e->matches(key).

bool operator== ( QKeySequence::StandardKey key, QKeyEvent * e )

Retourne true si key est actuellement li�e � la combinaison de touches sp�cifi�e par e.

�quivalent � e->matches(key).

Remerciements

Merci � Louis du Verdier pour la traduction et � Jonathan Courtois ainsi qu'� Maxime Gault pour leur relecture !