Тип QML MenuItem

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

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• font : шрифт
• group : MenuItemGroup
• iconName : строка
• iconSource : url
• menu : Меню
• role : перечисление
• separator : bool
• shortcut : keysequence
• subMenu : Меню
• text : строка
• visible : bool

Сигналы

• hovered()
• triggered()

Методы

• void toggle()

Подробное описание

Тип MenuItem предоставляет QML API для элементов нативного меню платформы.

Элемент меню состоит из значка (icon), текста (text) и сочетания клавиш.

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 если элемент не входит в группу.

iconName : string

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

MenuItem {
    iconName: "edit-undo"
    iconSource: "qrc:/images/undo.png"
}

См. также iconSource и QIcon::fromTheme().

iconSource : url

Это свойство указывает URL-адрес значка элемента меню.

MenuItem {
    iconName: "edit-undo"
    iconSource: "qrc:/images/undo.png"
}

См. также iconName.

[только для чтения] menu : Меню

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

role : перечисление

Это свойство указывает роль элемента. Роль определяет, должен ли элемент помещаться в меню приложения на macOS.

Доступные значения:

Указание роли действует только на элементы в непосредственном меню строки меню, а не в подменю этих меню. Например, если в строке меню есть меню «Файл» и меню «Файл» имеет подменю, указание роли для элементов в этом подменю не имеет никакого эффекта. Они никогда не будут перемещены в меню приложения.

separator : bool

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

См. также MenuSeparator.

shortcut : keysequence

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

Сочетание клавиш может быть задано одним из стандартных сочетаний клавиш клавиатуры, или оно может быть указано строкой, содержащей последовательность до четырёх нажатий клавиш, необходимых для активации сочетания клавиш.

Значение по умолчанию — пустое сочетание клавиш.

MenuItem {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

[только для чтения] subMenu : Меню

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

text : string

Это свойство указывает текст элемента меню.

visible : bool

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

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

hovered()

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

triggered()

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

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

void toggle()

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