快捷 QML 类型

提供键盘快捷方式。更多信息...

导入语句	import QtQuick

包括继承成员的全体成员列表

属性

autoRepeat : bool
context : 枚举
enabled : bool
nativeText : string
portableText : string
sequence : keysequence
sequences : list<keysequence>

信号

activated()
activatedAmbiguously()

详细描述

Shortcut 类型允许您处理键盘快捷方式。快捷方式可以设置为以下标准键盘快捷方式之一，或可以描述为包含最多四个按键序列的字符串，这些按键序列用于激活快捷方式。

Item {
    id: view

    property int currentIndex

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

也可以设置多个快捷方式序列，以便通过不同的按键序列激活组合。

另请参阅 键和 shortcutOverride。

属性文档

autoRepeat : bool

此属性表示快捷方式是否可以自动重复。

默认值为 true。

context : enumeration

此属性表示快捷方式上下文。

支持的值有

常量	描述
`Qt.WindowShortcut`	(默认) 当其父项处于活动的顶层窗口中时，快捷方式处于活动状态。
`Qt.ApplicationShortcut`	当应用程序的其中一个窗口处于活动状态时，快捷方式处于活动状态。 Shortcut { sequence: StandardKey.Quit context: Qt.ApplicationShortcut onActivated: Qt.quit() }

enabled : bool

此属性表示是否启用快捷方式。

默认值为 true。

nativeText : string [只读]

此属性提供快捷方式的按键序列，作为平台特定的字符串。这意味着它将被翻译，在 macOS 上，它将类似于菜单栏中的按键序列。最好将此文本显示给用户（例如，在工具提示中）。

另请参阅 sequence 和 portableText.

portableText : string [只读]

此属性以“便携”格式提供快捷键键序列字符串，适用于读写文件。在许多情况下，它看起来与Windows和X11上的本地文本相似。

另请参阅 sequence 和 nativeText.

sequence : keysequence

此属性包含快捷键键序列。键序列可以设置为标准键盘快捷键之一，或者可以用字符串描述，包含最多四个按键，这些按键用于激活快捷键。

默认值为空键序列。

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

注意： 由于标准键在某些平台上可以解析为一个快捷键，但其他平台上可以有多个快捷键，我们建议始终为标准键使用sequences。

另请参阅 sequences.

sequences : list<keysequence>

此属性包含多个快捷键键序列。键序列可以设置为标准键盘快捷键之一，或者可以用字符串描述，包含最多四个按键，这些按键用于激活快捷键。

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

信号文档

activated()

当快捷键被激活时，发出此信号。

注意： 相应处理程序是onActivated。

activatedAmbiguously()

当快捷键模糊激活时，发出此信号，意味着它与多个快捷键的起始部分相匹配。

注意： 相应处理程序是onActivatedAmbiguously。