如何在Qt/QML 6的菜单栏项中添加快捷键提示

在Qt6中，MenuItem不再自带shortcut属性，直接给Action设置shortcut不会自动在菜单项右侧显示快捷键文本。通过自定义Menu的delegate，并利用MenuItem的action属性关联对应的Action对象，就能动态获取并显示快捷键。

完整实现代码 #

Menu {
    id: helpMenu
    title: "&Help"

    // 自定义菜单项代理，实现左右布局的文本和快捷键
    delegate: MenuItem {
        id: control

        contentItem: RowLayout {
            anchors.fill: parent
            spacing: 10

            // 左侧显示菜单项文本
            Text {
                text: control.text
                Layout.fillWidth: true
                Layout.alignment: Qt.AlignLeft | Qt.AlignVCenter
                color: control.enabled ? control.textColor : control.disabledTextColor
            }

            // 右侧显示快捷键文本，仅当Action存在有效快捷键时显示
            Text {
                text: control.action ? control.action.shortcut.toString(QKeySequence.NativeText) : ""
                visible: control.action && !control.action.shortcut.isEmpty()
                Layout.alignment: Qt.AlignRight | Qt.AlignVCenter
                color: control.enabled ? control.textColor : control.disabledTextColor
            }
        }
    }

    // 带快捷键的帮助菜单Action
    Action {
        text: "Usage guide"
        // 使用标准键常量适配多平台，也可直接写"F1"
        shortcut: StandardKey.HelpContents
        onTriggered: {
            // 此处添加触发后的逻辑
            console.log("打开使用指南")
        }
    }

    Action {
        text: "About"
        shortcut: "Ctrl+A"
        onTriggered: {
            console.log("打开关于页面")
        }
    }
}

关键实现说明 #

1. 关联Action对象：MenuItem的action属性会自动绑定到Menu中对应的Action，通过control.action.shortcut可以直接获取快捷键信息。
2. 格式化快捷键文本：使用shortcut.toString(QKeySequence.NativeText)生成符合当前系统习惯的快捷键文本（比如Windows下显示Ctrl+A，Mac下显示⌘+A）。
3. 条件显示：通过visible属性判断，仅当Action存在有效快捷键时才显示右侧文本，避免空内容占位。
4. 样式同步：同步文本颜色与MenuItem的启用/禁用状态，保证菜单样式统一。

内容的提问来源于stack exchange，提问作者staticf0x