QKeyEvent Class

Documentation des fonctions membres

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

Crée un objet d'événement clé.

Le paramètre ` type ` doit prendre l’une des valeurs suivantes : ` QEvent::KeyPress`, ` QEvent::KeyRelease` ou ` QEvent::ShortcutOverride`.

Int key correspond au code de l'Qt::Key que la boucle d'événements doit surveiller. Si key est égal à 0, l’événement ne résulte pas d’une touche connue ; il peut par exemple provenir d’une séquence de composition ou d’une macro clavier. Le paramètre modifiers contient les modificateurs du clavier, et la valeur text fournie correspond au texte Unicode généré par la touche. Si autorep est vrai, isAutoRepeat() sera vrai. count correspond au nombre de touches impliquées dans l’événement.

QKeyEvent::QKeyEvent(QEvent::Type type, int key, Qt::KeyboardModifiers modifiers, quint32 nativeScanCode, quint32 nativeVirtualKey, quint32 nativeModifiers, const QString &text = QString(), bool autorep = false, quint16 count = 1, const QInputDevice *device = QInputDevice::primaryKeyboard())

Crée un objet d'événement clé.

Le paramètre ` type ` doit prendre l'une des valeurs suivantes : ` QEvent::KeyPress`, ` QEvent::KeyRelease` ou ` QEvent::ShortcutOverride`.

Int key correspond au code de l'Qt::Key que la boucle d'événements doit surveiller. Si key est égal à 0, l’événement ne résulte pas d’une touche connue ; il peut par exemple provenir d’une séquence de composition ou d’une macro clavier. Le paramètre modifiers contient les modificateurs du clavier, et la valeur text fournie correspond au texte Unicode généré par la touche. Si autorep est vrai, isAutoRepeat() sera vrai. count correspond au nombre de touches impliquées dans l’événement.

En plus des données habituelles relatives à l’événement de touche, cet objet contient également nativeScanCode, nativeVirtualKey et nativeModifiers. Ces données supplémentaires sont utilisées par le système de raccourcis pour déterminer quels raccourcis déclencher.

[protected delete] QKeyEvent::QKeyEvent(QKeyEvent &&)

Crée par « move » une instance de ` QKeyEvent`. Cette fonction est supprimée.

int QKeyEvent::count() const

Renvoie le nombre de clés impliquées dans cet événement. Si text() n'est pas vide, il s'agit simplement de la longueur de la chaîne.

Voir aussi Qt::WA_KeyCompression.

bool QKeyEvent::isAutoRepeat() const

Renvoie « true » si cet événement provient d'une touche à répétition automatique ; renvoie « false » s'il provient d'une première pression sur la touche.

Notez que si l'événement est un événement compressé à touches multiples dû en partie à la répétition automatique, cette fonction peut renvoyer soit « true », soit « false » de manière indéterminée.

int QKeyEvent::key() const

Renvoie le code de la touche qui a été enfoncée ou relâchée.

Consultez Qt::Key pour obtenir la liste des codes clavier. Ces codes sont indépendants du système de fenêtrage sous-jacent. Notez que cette fonction ne fait pas la distinction entre les majuscules et les minuscules ; utilisez la fonction text() (qui renvoie le texte Unicode généré par la touche) à cette fin.

Une valeur égale à 0 ou à Qt::Key_unknown signifie que l'événement n'est pas le résultat d'une touche connue ; il peut s'agir, par exemple, d'une séquence de composition, d'une macro clavier ou d'une compression d'événements de touches.

Voir également Qt::WA_KeyCompression.

[since 6.0] QKeyCombination QKeyEvent::keyCombination() const

Renvoie un objet ` QKeyCombination ` contenant à la fois les méthodes ` key()` et ` modifiers()` associées à cet événement.

Cette fonction a été introduite dans Qt 6.0.

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

Renvoie « true » si l'événement de touche correspond à la norme indiquée key; sinon, renvoie « false ».

Qt::KeyboardModifiers QKeyEvent::modifiers() const

Renvoie les indicateurs de modificateurs du clavier qui étaient actifs immédiatement après la survenue de l'événement.

Voir aussi ` QGuiApplication::keyboardModifiers()` ().

quint32 QKeyEvent::nativeModifiers() const

Renvoie les modificateurs natifs d'un événement de touche. Si l'événement de touche ne contient pas ces données, la valeur 0 est renvoyée.

quint32 QKeyEvent::nativeScanCode() const

Renvoie le code de balayage natif de l'événement de touche. Si l'événement de touche ne contient pas cette donnée, la valeur 0 est renvoyée.

quint32 QKeyEvent::nativeVirtualKey() const

Renvoie la touche virtuelle native ou le symbole de touche de l'événement de touche. Si l'événement de touche ne contient pas cette information, la valeur 0 est renvoyée.

QString QKeyEvent::text() const

Renvoie le texte Unicode généré par cette clé.

Le texte n'est pas limité à la plage imprimable des points de code Unicode et peut inclure des caractères de contrôle ou des caractères issus d'autres catégories Unicode, y compris QChar::Other_PrivateUse.

Le texte peut également être vide, par exemple lorsque des touches de modification telles que Maj, Ctrl, Alt et Méta sont enfoncées (selon la plate-forme). La fonction key() renvoie toujours une valeur valide.

Voir également Qt::WA_KeyCompression.

[protected delete] QKeyEvent &QKeyEvent::operator=(QKeyEvent &&)

La commande « Move » affecte « other » à cette instance « QKeyEvent ». Cette fonction est supprimée.

[noexcept protected default] QKeyEvent &QKeyEvent::operator=(const QKeyEvent &other)

Attribue par copie l'other à cette instance d'QKeyEvent.