Тип 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 : последовательность клавиш
• subMenu : Menu
• text : строка
• 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"
}

Эта документация была добавлена в 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 : строка

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

visible : bool

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

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

hovered()

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

triggered()

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

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

void toggle()

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