Тип QML MenuItem

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

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• font : font
• group : MenuItemGroup
• iconName : строка
• iconSource : url
• menu : Menu
• role : перечисление
• separator : bool
• shortcut : последовательность_клавиш
• subMenu : Menu
• text : строка
• visible : bool

Сигналы

• void hovered()
• void 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 не гарантируют сохранение совместимости в будущих версиях.

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

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

checkable : bool

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

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

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

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

checked : bool

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

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

enabled : bool

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

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

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

font : font

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

См. также text.

group : MenuItemGroup

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

iconName : строка

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

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 : Menu

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

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

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

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

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

separator : bool

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

См. также MenuSeparator.

shortcut : последовательность_клавиш

Это свойство определяет горячую клавишу элемента меню.

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

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

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

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

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

text : строка

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

visible : bool

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

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

void hovered()

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

void triggered()

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

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

void toggle()

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