Тип 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()
    }
}

Примечание: Типы в модулях Qt.labs не гарантируют сохранения совместимости в будущих версиях.

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

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

checkable : bool

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

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

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

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

checked : bool

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

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

enabled : bool

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

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

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

font : font

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

См. также text.

group : MenuItemGroup

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

[с версии 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 на противоположное.