Shortcut QML Type
Provides keyboard shortcuts More...
Import Statement: | import QtQuick 2.5 |
Since: | Qt 5.5 |
Properties
- autoRepeat : bool
- context : enumeration
- enabled : bool
- nativeText : string
- portableText : string
- sequence : keysequence
Signals
Detailed Description
The Shortcut type provides a way of handling keyboard shortcuts. The shortcut can be set to one of the standard keyboard shortcuts, or it can be described with a string containing a sequence of up to four key presses that are needed to activate the shortcut.
Item { id: view property int currentIndex Shortcut { sequence: StandardKey.NextChild onActivated: view.currentIndex++ } }
See also Keys.
Property Documentation
autoRepeat : bool
This property holds whether the shortcut can auto repeat.
The default value is true
.
context : enumeration
This property holds the shortcut context.
Supported values are:
-
Qt.WindowShortcut
(default) - The shortcut is active when its parent item is in an active top-level window. -
Qt.ApplicationShortcut
- The shortcut is active when one of the application's windows are active.
Shortcut { sequence: StandardKey.Quit context: Qt.ApplicationShortcut onActivated: Qt.quit() }
enabled : bool
This property holds whether the shortcut is enabled.
The default value is true
.
nativeText : string
This property provides the shortcut's key sequence as a platform specific string. This means that it will be shown translated, and on macOS it will resemble a key sequence from the menu bar. It is best to display this text to the user (for example, on a tooltip).
This QML property was introduced in Qt 5.6.
See also sequence and portableText.
portableText : string
This property provides the shortcut's key sequence as a string in a "portable" format, suitable for reading and writing to a file. In many cases, it will look similar to the native text on Windows and X11.
This QML property was introduced in Qt 5.6.
See also sequence and nativeText.
sequence : keysequence
This property holds the shortcut's key sequence. The key sequence can be set to one of the standard keyboard shortcuts, or it can be described with a string containing a sequence of up to four key presses that are needed to activate the shortcut.
The default value is an empty key sequence.
Shortcut { sequence: "Ctrl+E,Ctrl+W" onActivated: edit.wrapMode = TextEdit.Wrap }
Signal Documentation
activated()
This signal is emitted when the shortcut is activated.
The corresponding handler is onActivated
.
activatedAmbiguously()
This signal is emitted when the shortcut is activated ambigously, meaning that it matches the start of more than one shortcut.
The corresponding handler is onActivatedAmbiguously
.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qml-qtquick-shortcut.html