Тип QML MenuItem

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

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• font : шрифт
• group : MenuItemGroup
• icon
  • icon.source : url
  • icon.name : строка
  • icon.mask : bool
• menu : Меню
• role : перечисление
• separator : bool
• shortcut : последовательность клавиш
• subMenu : Меню
• 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 не гарантируют совместимость в будущих версиях.

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

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

checkable : bool

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

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

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

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

checked : bool

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

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

enabled : bool

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

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

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

font : шрифт

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

См. также text.

group : MenuItemGroup

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

icon.source : url

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

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 : Меню

Это свойство содержит меню, к которому принадлежит элемент, или 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()

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

triggered()

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

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

void toggle()

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