Тип 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 предоставляет 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()
    }
}

Примечание: Типы в модулях 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 на противоположное состояние.