Тип 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 если элемент не принадлежит к группе.

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