Keys QML Type (Uncreatable)

Stellt die Schlüsselverwaltung für Items bereit. Mehr...

Hinweis: Dies ist ein nicht erstellbarer Typ. Er kann in QML nicht instanziiert werden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• enabled : bool
• forwardTo : list<Item>
• priority : enumeration

Signale

• asteriskPressed(KeyEvent event)
• backPressed(KeyEvent event)
• backtabPressed(KeyEvent event)
• callPressed(KeyEvent event)
• cancelPressed(KeyEvent event)
• context1Pressed(KeyEvent event)
• context2Pressed(KeyEvent event)
• context3Pressed(KeyEvent event)
• context4Pressed(KeyEvent event)
• deletePressed(KeyEvent event)
• digit0Pressed(KeyEvent event)
• digit1Pressed(KeyEvent event)
• digit2Pressed(KeyEvent event)
• digit3Pressed(KeyEvent event)
• digit4Pressed(KeyEvent event)
• digit5Pressed(KeyEvent event)
• digit6Pressed(KeyEvent event)
• digit7Pressed(KeyEvent event)
• digit8Pressed(KeyEvent event)
• digit9Pressed(KeyEvent event)
• downPressed(KeyEvent event)
• enterPressed(KeyEvent event)
• escapePressed(KeyEvent event)
• flipPressed(KeyEvent event)
• hangupPressed(KeyEvent event)
• leftPressed(KeyEvent event)
• menuPressed(KeyEvent event)
• noPressed(KeyEvent event)
• pressed(KeyEvent event)
• released(KeyEvent event)
• returnPressed(KeyEvent event)
• rightPressed(KeyEvent event)
• selectPressed(KeyEvent event)
• shortcutOverride(KeyEvent event)
• spacePressed(KeyEvent event)
• tabPressed(KeyEvent event)
• upPressed(KeyEvent event)
• volumeDownPressed(KeyEvent event)
• volumeUpPressed(KeyEvent event)
• yesPressed(KeyEvent event)

Ausführliche Beschreibung

Alle visuellen Primitive unterstützen die Tastenverarbeitung über den Typ „Keys attaching“. Tasten können über die Signaleigenschaften „onPressed“ und „onReleased“ verarbeitet werden.

Die Signaleigenschaften verfügen über einen „ KeyEvent “-Parameter namens „event“, der Details zum Ereignis enthält. Wenn ein Tastenereignis verarbeitet wird , sollte „event.accepted“ auf „true“ gesetzt werden, um zu verhindern, dass das Ereignis in der Elementhierarchie weiterverbreitet wird.

Anwendungsbeispiel

Das folgende Beispiel zeigt, wie der allgemeine „onPressed“-Handler verwendet werden kann, um auf eine bestimmte Taste zu prüfen; in diesem Fall die linke Cursortaste:

Item {
    anchors.fill: parent
    focus: true
    Keys.onPressed: (event)=> {
        if (event.key == Qt.Key_Left) {
            console.log("move left");
            event.accepted = true;
        }
    }
}

Einige Tasten können alternativ über spezifische Signal-Eigenschaften verarbeitet werden, zum Beispiel „onSelectPressed“. Diese Handler setzen „event.accepted “ automatisch auf „true“.

Item {
    anchors.fill: parent
    focus: true
    Keys.onLeftPressed: console.log("move left")
}

Eine Liste der Tastaturcodes finden Sie unter Qt.Key.

Prioritäten bei der Tastenverarbeitung

Der Anbindungstyp „Keys“ kann so konfiguriert werden, dass Tastenereignisse vor oder nach dem Element verarbeitet werden, an das er angebunden ist. Dies ermöglicht es, Ereignisse abzufangen, um das Standardverhalten eines Elements zu überschreiben, oder als Ausweichlösung für Tasten zu dienen, die vom Element nicht verarbeitet werden.

Wenn „ priority “ auf „Keys.BeforeItem“ (Standard) gesetzt ist, lautet die Reihenfolge der Verarbeitung von Tastenereignissen wie folgt:

1. Elemente, die in forwardTo
2. bestimmten Tastenbehandlungsroutinen, z. B. in den Handlern „onReturnPressed“
3. onPressed- und onReleased-Handler
4. Element-spezifische Tastenverarbeitung, z. B. die Tastenverarbeitung von „ TextInput “
5. übergeordnetes Element

Wenn die Priorität auf „Keys.AfterItem“ gesetzt ist, lautet die Reihenfolge der Tastenereignisverarbeitung:

1. Element-spezifische Tastenbehandlung, z. B. Tastenbehandlung von „ TextInput “
2. In forwardTo
3. spezifischen Tastenbehandlungsroutinen, z. B. „onReturnPressed“
4. onPressed- und onReleased-Handler
5. übergeordnetes Element

Wird das Ereignis während eines der oben genannten Schritte akzeptiert, wird die Tastenweitergabe beendet.

Siehe auch KeyEvent und KeyNavigation attached property.

Eigenschaftsdokumentation

enabled : bool

Dieses Flag aktiviert die Tastenbehandlung, wenn es auf „true“ gesetzt ist (Standard); andernfalls werden keine Tastenbehandlungsfunktionen aufgerufen.

forwardTo : list<Item> [read-only]

Diese Eigenschaft ermöglicht es, Tastendrücke, das Loslassen von Tasten und Tastatureingaben aus Eingabemethoden an andere Elemente weiterzuleiten. Dies kann nützlich sein, wenn Sie möchten, dass ein Element bestimmte Tasten (z. B. die Auf- und Ab-Pfeiltasten) verarbeitet und ein anderes Element andere Tasten (z. B. die Links- und Rechts-Pfeiltasten). Sobald ein Element, an das Tastenereignisse weitergeleitet wurden, das Ereignis akzeptiert, wird es nicht mehr an nachfolgende Elemente in der Liste weitergeleitet.

In diesem Beispiel werden Tastenereignisse an zwei Listen weitergeleitet:

Item {
    ListView {
        id: list1
        // ...
    }
    ListView {
        id: list2
        // ...
    }
    Keys.forwardTo: [list1, list2]
    focus: true
}

Um die Reihenfolge zu sehen, in der Ereignisse bei Verwendung von `forwardTo` empfangen werden, siehe Key Handling Priorities.

priority : enumeration

Diese Eigenschaft legt fest, ob die Schlüssel vor oder nach der eigenen Schlüsselverarbeitung des angehängten Elements verarbeitet werden.

Siehe auch „ Key Handling Priorities “.

Signal-Dokumentation

asteriskPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Stern-Taste „*“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

backPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Zurück-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

backtabPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Tastenkombination „Umschalt+Tab“ (Backtab) gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

callPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Call-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

cancelPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die „Abbrechen“-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

context1Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Taste „Context1“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

context2Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Taste „Context2“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

context3Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Taste „Context3“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

context4Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Taste „Context4“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

deletePressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Entf-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit0Pressed(KeyEvent event)

Dieses Signal wird ausgegeben, wenn die Ziffer „0“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit1Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Ziffer „1“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit2Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Ziffer „2“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit3Pressed(KeyEvent event)

Dieses Signal wird ausgegeben, wenn die Ziffer „3“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit4Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Ziffer „4“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit5Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Ziffer „5“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit6Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Ziffer „6“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit7Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Ziffer „7“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit8Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Ziffer „8“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

digit9Pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Ziffer „9“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

downPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Abwärtspfeiltaste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

enterPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Eingabetaste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

escapePressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Escape-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

flipPressed(KeyEvent event)

Dieses Signal wird ausgegeben, wenn die Flip-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

hangupPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Auflegen-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

leftPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Pfeiltaste nach links gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

menuPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Menütaste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

noPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Taste „No“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

pressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn eine Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

released(KeyEvent event)

Dieses Signal wird ausgelöst, wenn eine Taste losgelassen wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

returnPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Return-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

rightPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Pfeiltaste nach rechts gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

selectPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Select-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

shortcutOverride(KeyEvent event)

Dieses Signal wird ausgelöst, wenn eine Taste gedrückt wurde, die möglicherweise als Tastenkombination verwendet werden könnte. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

Setzen Sie „ event.accepted “ auf „ true “, wenn Sie verhindern möchten, dass die gedrückte Taste von anderen Typen, wie z. B. „ Shortcut “, als Tastenkombination verwendet wird. Beispiel:

Item {
    id: escapeItem
    focus: true

    // Ensure that we get escape key press events first.
    Keys.onShortcutOverride: (event)=> event.accepted = (event.key === Qt.Key_Escape)

    Keys.onEscapePressed: {
        console.log("escapeItem is handling escape");
        // event.accepted is set to true by default for the specific key handlers
    }
}

Shortcut {
    sequence: "Escape"
    onActivated: console.log("Shortcut is handling escape")
}

Wie bei den anderen Signalen wird „ shortcutOverride “ für ein Element nur dann ausgelöst, wenn dieses Element „ activeFocus “ aufweist.

Siehe auch „ Shortcut “.

spacePressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Leertaste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

tabPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Tabulatortaste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

upPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Aufwärtspfeiltaste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

volumeDownPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Taste „Lautstärke verringern“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

volumeUpPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die Taste „Lauter“ gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.

yesPressed(KeyEvent event)

Dieses Signal wird ausgelöst, wenn die „Ja“-Taste gedrückt wurde. Der Parameter „ event “ liefert Informationen zu diesem Ereignis.