KeyEvent QML Type
Liefert Informationen über ein Schlüsselereignis. Mehr...
Import Statement: | import QtQuick |
Eigenschaften
- accepted : bool
- count : int
- isAutoRepeat : bool
- key : int
- modifiers : int
- nativeScanCode : quint32
- text : string
Methoden
- bool matches(StandardKey matchKey)
Detaillierte Beschreibung
Im Folgenden wird zum Beispiel die Eigenschaft "Status" des Elements geändert, wenn die Eingabetaste gedrückt wird:
Item { focus: true Keys.onPressed: (event)=> { if (event.key == Qt.Key_Enter) state = 'ShowDetails'; } }
Dokumentation der Eigenschaft
accepted : bool |
Die Einstellung accepted auf true verhindert, dass das Tastenereignis an das übergeordnete Element weitergegeben wird.
Wenn das Element auf das Tastenereignis reagiert, sollte es im Allgemeinen akzeptiert werden, damit die Vorgängerelemente nicht ebenfalls auf das gleiche Ereignis reagieren.
count : int |
Diese Eigenschaft enthält die Anzahl der Schlüssel, die an diesem Ereignis beteiligt sind. Wenn KeyEvent::text nicht leer ist, ist dies einfach die Länge der Zeichenkette.
isAutoRepeat : bool |
Diese Eigenschaft gibt an, ob dieses Ereignis von einer sich automatisch wiederholenden Taste stammt.
key : int |
Diese Eigenschaft enthält den Code der Taste, die gedrückt oder losgelassen wurde.
Siehe Qt.Key für die Liste der Tastaturcodes. Diese Codes sind unabhängig von dem zugrunde liegenden Fenstersystem. Beachten Sie, dass diese Funktion nicht zwischen Groß- und Kleinbuchstaben unterscheidet; verwenden Sie zu diesem Zweck die Eigenschaft text.
Ein Wert von 0 oder Qt.Key_Unknown bedeutet, dass das Ereignis nicht das Ergebnis einer bekannten Taste ist; es kann z. B. das Ergebnis einer Kompositionssequenz, eines Tastaturmakros oder einer Tastenereigniskompression sein.
modifiers : int |
Diese Eigenschaft enthält die Tastaturmodifizierungsflags, die unmittelbar vor dem Auftreten des Ereignisses vorhanden waren.
Sie enthält eine bitweise Kombination von numerischen Werten (wie in Qt::KeyboardModifier):
Konstante | Beschreibung |
---|---|
Qt.NoModifier | Keine Modifikatortaste ist gedrückt. |
Qt.ShiftModifier | }Eine Umschalttaste auf der Tastatur ist gedrückt. |
Qt.ControlModifier | Eine Strg-Taste auf der Tastatur ist gedrückt. |
Qt.AltModifier | Eine Alt-Taste auf der Tastatur ist gedrückt. |
Qt.MetaModifier | Eine Meta-Taste auf der Tastatur wird gedrückt. |
Qt.KeypadModifier | Eine Taste des Tastenfelds wird gedrückt. |
Qt.GroupSwitchModifier | Nur X11. Eine Mode_switch-Taste auf der Tastatur wird gedrückt. |
Zum Beispiel, um auf eine Kombination aus Umschalttaste und Eingabetaste zu reagieren:
Item { focus: true Keys.onPressed: (event)=> { if ((event.key == Qt.Key_Enter) && (event.modifiers & Qt.ShiftModifier)) doSomething(); } }
nativeScanCode : quint32 |
Diese Eigenschaft enthält den nativen Scan-Code der Taste, die gedrückt wurde. Sie wird von QKeyEvent unverändert weitergegeben.
Siehe auch QKeyEvent::nativeScanCode().
text : string |
Diese Eigenschaft enthält den Unicode-Text, den die Taste erzeugt hat. Der zurückgegebene Text kann eine leere Zeichenkette sein, wenn Modifikatortasten wie Shift, Control, Alt und Meta gedrückt oder losgelassen werden. In solchen Fällen wird key
einen gültigen Wert enthalten.
Dokumentation der Methode
bool matches(StandardKey matchKey) |
Gibt true
zurück, wenn das Tastenereignis dem angegebenen Standard matchKey entspricht; andernfalls wird false
zurückgegeben.
Item { focus: true Keys.onPressed: (event)=> { if (event.matches(StandardKey.Undo)) myModel.undo(); else if (event.matches(StandardKey.Redo)) myModel.redo(); } }
Siehe auch QKeySequence::StandardKey.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.