Тип QML MenuItem

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

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• font : шрифт
• group : MenuItemGroup
• icon
  • icon.mask : bool
  • icon.name : строка
  • icon.source : url
• menu : Меню
• role : перечисление
• separator : bool
• shortcut : последовательность клавиш
• subMenu : Меню
• text : строка
• visible : bool

Сигналы

• hovered()
• triggered()

Методы

• void toggle()

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

Тип MenuItem предоставляет API QML для элементов нативных меню платформы.

Элемент меню состоит из иконки, текста и сочетания клавиш.

Menu {
    id: zoomMenu

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

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

См. также Меню и MenuItemGroup.

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

checkable : bool

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

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

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

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

checked : bool

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

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

enabled : bool

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

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

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

font : шрифт

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

См. также text.

group : MenuItemGroup

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

[since Qt.labs.platform 1.1 (Qt 5.12)] 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 : Меню

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

role : перечисление

Это свойство содержит роль элемента. Роль определяет, должен ли элемент быть помещен в меню приложения на macOS.

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

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

separator : bool

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

См. также MenuSeparator.

shortcut : последовательность клавиш

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

Сочетание клавиш может быть установлено на одно из стандартных сочетаний клавиш, или оно может быть указано строкой, содержащей последовательность до четырех нажатий клавиш, необходимых для активации сочетания клавиш.

Значение по умолчанию — пустая последовательность клавиш.

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

[только для чтения] subMenu : Меню

Это свойство содержит подменю, содержащееся в элементе, или null если элемент не является элементом подменю.

text : строка

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

visible : bool

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

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

hovered()

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

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

triggered()

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

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

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

void toggle()

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