Тип QML MenuItem

Элемент нативного меню. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• font : font
• group : MenuItemGroup
• icon
  • icon.mask : bool
  • icon.name : string
  • icon.source : url
• menu : Menu
• role : перечисление
• separator : bool
• shortcut : keysequence
• subMenu : Menu
• text : string
• visible : bool

Сигналы

• hovered()
• triggered()

Методы

• void toggle()

Подробное описание

Тип 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 не гарантируют сохранение совместимости в будущих версиях.

См. также Menu и MenuItemGroup.

Документация по свойствам

checkable : bool

Это свойство указывает, можно ли установить для элемента флажок.

Элемент меню с флагом имеет состояние включения/выключения. Например, в текстовом редакторе элемент меню "Жирный шрифт" может быть включён или выключен. Элемент меню без флага — это элемент команды, который просто выполняется, например, сохранение файла.

Значение по умолчанию — false.

См. также checked и MenuItemGroup.

checked : bool

Это свойство указывает, установлен ли флажок для элемента (включено) или снят (выключено). Значение по умолчанию — false.

См. также checkable и MenuItemGroup.

enabled : bool

Это свойство указывает, активен ли элемент. Значение по умолчанию — true.

Отключенные элементы не могут быть активированы пользователем. Они не исчезают из меню, но отображаются так, что видно, что они недоступны. Например, они могут отображаться с использованием только оттенков серого.

Когда элемент отключён, его невозможно активировать с помощью сочетания клавиш.

font : font

Это свойство содержит шрифт элемента меню.

См. также text.

group : MenuItemGroup

Это свойство содержит группу, к которой относится элемент, или null если элемент не входит в группу.

icon.mask : bool

Это свойство содержит иконку элемента меню.

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.

Доступные значения:

Указание роли оказывает влияние только на элементы, которые находятся непосредственно в меню строки меню, а не в подменю этих меню. Например, если у вас есть меню "Файл" в строке меню, и это меню "Файл" имеет подменю, указание роли для элементов в этом подменю не оказывает никакого эффекта. Они никогда не будут перемещены в меню приложения.

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.

Документация по сигналам

hovered()

Этот сигнал излучается, когда пользователь наводит указатель мыши на элемент меню.

Примечание: Соответствующий обработчик — onHovered.

triggered()

Этот сигнал излучается, когда пользователь активирует элемент меню.

Примечание: Соответствующий обработчик — onTriggered.

Документация по методам

void toggle()

Переключает состояние checked на противоположное.