Auf dieser Seite

Shortcut QML Type

Stellt Tastaturkürzel bereit. Mehr...

Import Statement: import QtQuick

Eigenschaften

Signale

Ausführliche Beschreibung

Mit dem Typ „Shortcut“ können Sie Tastenkombinationen verwalten. Die Tastenkombination kann auf eine der Tasten „ standard keyboard shortcuts “ festgelegt werden oder durch eine Zeichenkette beschrieben werden, die eine Abfolge von bis zu vier Tastenanschlägen enthält, die zum „ activate “ der Tastenkombination erforderlich sind.

Item {
    id: view

    property int currentIndex

    Shortcut {
        sequences: [StandardKey.NextChild]
        onActivated: view.currentIndex++
    }
}

Es ist auch möglich, mehrere Tastenkombinationen sequences festzulegen, sodass die Tastenkombination über verschiedene Tastenfolgen activated werden kann.

Siehe auch „ Keys “ und „ shortcutOverride()“.

Dokumentation zu Eigenschaften

autoRepeat : bool

Diese Eigenschaft legt fest, ob die Tastenkombination automatisch wiederholt werden kann.

Der Standardwert lautet „ true “.

context : enumeration

Diese Eigenschaft enthält den Wert „ shortcut context “.

Unterstützte Werte sind:

KonstanteBeschreibung
Qt.WindowShortcut(Standard) Die Verknüpfung ist aktiv, wenn sich ihr übergeordnetes Element in einem aktiven Fenster der obersten Ebene befindet.
Qt.ApplicationShortcutDie Tastenkombination ist aktiv, wenn eines der Fenster der Anwendung aktiv ist.
Shortcut {
    sequence: StandardKey.Quit
    context: Qt.ApplicationShortcut
    onActivated: Qt.quit()
}

enabled : bool

Diese Eigenschaft gibt an, ob die Tastenkombination aktiviert ist.

Der Standardwert lautet „ true “.

nativeText : string [read-only]

Diese Eigenschaft liefert die Tastenkombination des Shortcuts als plattformspezifische Zeichenfolge. Das bedeutet, dass sie übersetzt angezeigt wird und unter macOS einer Tastenkombination aus der Menüleiste ähnelt. Es empfiehlt sich, diesen Text dem Benutzer anzuzeigen (beispielsweise in einem Tooltip).

Hinweis: Wenn mehrere Tastenfolgen festgelegt sind, gibt diese Eigenschaft nur die erste davon wieder.

Siehe auch sequence und portableText.

portableText : string [read-only]

Diese Eigenschaft liefert die Tastenkombination als Zeichenkette in einem „portablen“ Format, das sich zum Lesen und Schreiben in eine Datei eignet. In vielen Fällen entspricht sie dem nativen Text unter Windows und X11.

Hinweis: Wenn mehrere Tastenfolgen festgelegt sind, liefert diese Eigenschaft nur eine Darstellung der ersten davon.

Siehe auch sequence und nativeText.

sequence : keysequence

Diese Eigenschaft enthält die Tastenkombination des Shortcuts. Die Tastenkombination kann auf einen der Werte „ standard keyboard shortcuts “ gesetzt werden oder durch eine Zeichenfolge beschrieben werden, die eine Abfolge von bis zu vier Tastenanschlägen enthält, die zum „ activate “ des Shortcuts erforderlich sind.

Der Standardwert ist eine leere Tastenfolge.

Shortcut {
    sequence: "Ctrl+E,Ctrl+W"
    onActivated: edit.wrapMode = TextEdit.Wrap
}

Hinweis: Da Standardtasten auf einigen Plattformen einer Tastenkombination entsprechen können, auf anderen Plattformen jedoch mehreren Tastenkombinationen, empfehlen wir, für Standardtasten stets sequences zu verwenden.

Siehe auch sequences.

sequences : list<keysequence>

Diese Eigenschaft enthält mehrere Tastenfolgen für die Tastenkombination. Die Tastenfolgen können auf eine der Optionen „ standard keyboard shortcuts “ festgelegt werden oder als Zeichenfolgen beschrieben werden, die aus bis zu vier Tastenanschlägen bestehen, die zum Auslösen der Tastenkombination erforderlich sind: activate.

Shortcut {
    sequences: [StandardKey.Cut, "Ctrl+X", "Shift+Del"]
    onActivated: edit.cut()
}

Signal-Dokumentation

activated()

Dieses Signal wird ausgesendet, wenn die Verknüpfung aktiviert wird.

Hinweis: Der entsprechende Handler lautet „ onActivated “.

activatedAmbiguously()

Dieses Signal wird ausgegeben, wenn die Tastenkombination mehrdeutig ausgelöst wird, d. h., wenn sie mit dem Anfang von mehr als einer Tastenkombination übereinstimmt.

Hinweis: Der entsprechende Handler lautet „ onActivatedAmbiguously “.

© 2026 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.