MenuItem QML 类型

一个原生菜单项。更多...

导入语句	import Qt.labs.platform
继承	QtObject
被继承	MenuSeparator

所有成员的列表，包括继承的成员

属性

可选中 : bool
已选中 : bool
启用 : bool
字体 : font
组 : MenuItemGroup
图标 (从 Qt.labs.platform 1.1 (Qt 5.12) 开始)
- 图标掩码 : bool (从 Qt.labs.platform 1.1 (Qt 5.12) 开始)
- 图标名称 : string (从 Qt.labs.platform 1.1 (Qt 5.12) 开始)
- 图标源 : url (从 Qt.labs.platform 1.1 (Qt 5.12) 开始)
菜单 : Menu
角色 : 枚举
分隔符 : bool
快捷键 : keysequence
子菜单 : Menu
文本 : string
可见 : bool

信号

悬停()
触发()

方法

void 切换()

详细描述

MenuItem 类型提供了原生平台菜单项的 QML API。

一个菜单项由图标、文本和快捷键组成。

Menu {
    id: zoomMenu

    MenuItem {
        text: qsTr("Zoom In")
        shortcut: StandardKey.ZoomIn
        onTriggered: zoomIn()
    }

    MenuItem {
        text: qsTr("Zoom Out")
        shortcut: StandardKey.ZoomOut
        onTriggered: zoomOut()
    }
}

注意：Qt.labs 模块中的类型不一定在未来的版本中保持兼容。

另请参阅菜单和菜单项组。

属性文档

可选中 : bool

这个属性表示该项是否可以选中。

可复选的菜单项具有开启/关闭状态。例如，在文字处理器中，“加粗”菜单项可以是开启或关闭状态。不可复选的菜单项是直接执行的命令项，例如文件保存。

默认值是false。

另请参阅 checked和MenuItemGroup。

checked : bool

此属性表示该项是否被选中（开启）或未被选中（关闭）。默认值是false。

另请参阅 checkable和MenuItemGroup。

enabled : bool

此属性表示该项是否启用。默认值是true。

被禁用的项不能被用户触发。它们不会从菜单中消失，但显示的方式表明它们不可用。例如，仅以灰色调显示。

当一项被禁用时，无法通过其快捷键触发。

font : font

此属性表示菜单项的字体。

另请参阅 text。

group : MenuItemGroup

此属性表示该项所属的组，或null如果不在任何组中。

图标组
icon.mask : bool `[since Qt.labs.platform 1.1 (Qt 5.12)]`
icon.name : string `[since Qt.labs.platform 1.1 (Qt 5.12)]`
icon.source : url `[since Qt.labs.platform 1.1 (Qt 5.12)]`

此属性表示菜单项的图标。

MenuItem {
    icon.mask: true
    icon.name: "edit-undo"
    icon.source: "qrc:/images/undo.png"
}

此QML属性是在Qt.labs.platform 1.1（Qt 5.12）中引入的。

另请参阅 QIcon::fromTheme。

menu : Menu [只读]

此属性表示该项所属的菜单，或null如果不在任何菜单中。

role : 枚举

此属性表示该项的角色。角色决定了该项是否应该放在macOS的应用菜单中。

可用值

常量	描述
`MenuItem.NoRole`	该项不应放入应用菜单
`MenuItem.TextHeuristicRole`	根据操作的文本将项放入应用菜单（默认值）
`MenuItem.ApplicationSpecificRole`	将项与特定于应用程序的角色一起放在应用菜单中
`MenuItem.AboutQtRole`	该项处理“关于 Qt”菜单项。
`MenuItem.AboutRole`	该项应放在应用菜单中“关于”菜单项的位置。菜单项的文本将设置为“关于 <应用程序名称>”。应用程序名称是从应用捆绑包中的`Info.plist`文件中获取的（请参阅Qt for macOS - Deployment）。
`MenuItem.PreferencesRole`	该项应放在应用菜单中“首选项...”菜单项的位置。
`MenuItem.QuitRole`	该项应放在应用菜单中“退出”菜单项的位置。

仅对位于菜单栏直接菜单中的项目，而不是这些菜单的子菜单中的项目指定角色才有作用。例如，如果你的菜单栏中有一个“文件”菜单，并且“文件”菜单有一个子菜单，那么为该子菜单中的项目指定角色没有任何作用。它们永远不会被移动到应用程序菜单。

separator : bool

该属性表示项目是否为分隔线。默认值是false。

另请参阅 MenuSeparator。

shortcut : keysequence

该属性持有菜单项的快捷键。

快捷键序列可以设置为标准键盘快捷键之一，或者可以由一个字符串指定，该字符串包含最多四个必要的按键序列以触发快捷键。

默认值是一个空键序列。

MenuItem {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

subMenu : Menu [只读]

该属性持有项目包含的子菜单，或者如果项目不是子菜单项目则为null。

text : string

该属性持有菜单项的文本。

visible : bool

该属性持有项目是否可见。默认值是true。

信号文档

悬停()

当用户悬停菜单项时，会发出此信号。

注意：相应的处理程序是onHovered。

触发()

当用户触发菜单项时，会发出此信号。

注意：相应的处理程序是onTriggered。

方法文档

void toggle()

将checked状态切换到其相反状态。