Тип QML MenuItem

MenuItem предоставляет элемент для добавления в меню или строку меню. Подробнее...

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

Свойства

• action : Действие
• checkable : bool
• checked : bool
• enabled : bool
• exclusiveGroup : ExclusiveGroup
• iconName : строка
• iconSource : url
• shortcut : последовательность клавиш
• text : строка
• type : перечисление
• visible : bool

Сигналы

• toggled(checked)
• triggered()

Методы

• void trigger()

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

Menu {
    text: "Edit"

    MenuItem {
        text: "Cut"
        shortcut: "Ctrl+X"
        onTriggered: ...
    }

    MenuItem {
        text: "Copy"
        shortcut: "Ctrl+C"
        onTriggered: ...
    }

    MenuItem {
        text: "Paste"
        shortcut: "Ctrl+V"
        onTriggered: ...
    }
}

См. также MenuBar, Меню, Разделитель меню и Действие.

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

action : Действие

Действие, привязанное к этому пункту меню. Оно будет предоставлять значения для всех свойств пункта меню. Однако можно переопределить свойства действия text, iconSource, и iconName, просто назначив эти свойства, что позволит некоторую настройку.

Кроме того, сигналы пункта меню triggered() и toggled() не будут генерироваться. Вместо них будут генерироваться сигналы действия triggered() и toggled().

По умолчанию null, что означает, что к пункту меню не привязано никакого действия.

checkable : bool

Указывает, может ли пункт меню быть отмеченным или переключенным. По умолчанию false.

См. также checked.

checked : bool

Если пункт меню может быть отмечен, это свойство отражает его состояние отметки. По умолчанию false.

См. также checkable и Action::toggled.

enabled : bool

Указывает, включен ли пункт меню и реагирует ли он на взаимодействие пользователя. По умолчанию true.

exclusiveGroup : ExclusiveGroup

Если пункт меню может быть отмечен, к нему может быть прикреплена группа ExclusiveGroup. Все пункты меню, использующие одну и ту же группу, и, соответственно, любые действия, использующие её, становятся взаимоисключающими, то есть только последний отмеченный пункт меню будет фактически отмечен.

По умолчанию null, что означает, что исключительного поведения ожидать не стоит.

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

iconName : строка

Устанавливает имя значка для значка пункта меню MenuItem. Это выберет значок с заданным именем из текущей темы. Перезаписывает свойство iconName привязанного действия элемента. По умолчанию пустая строка.

Примечание: Это свойство требует QApplication.

См. также iconSource и Action::iconName.

iconSource : url

Устанавливает URL-адрес файла или ресурса значка для значка пункта меню MenuItem. Перезаписывает свойство iconSource привязанного действия элемента. По умолчанию пустой URL.

См. также iconName и Action::iconSource.

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

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

По умолчанию пустая строка.

MenuItem {
    id: copyItem
    text: qsTr("&Copy")
    shortcut: StandardKey.Copy
}

См. также Action::shortcut.

text : строка

Текст пункта меню. Перезаписывает свойство text привязанного действия элемента.

Мемоники поддерживаются с помощью префикса символа сочетания клавиш &. Например, "\&Open" привяжет сочетание клавиш Alt-O к пункту меню "Open". Обратите внимание, что не все платформы поддерживают мемоники.

По умолчанию пустая строка.

См. также Action::text.

[только для чтения] type : перечисление

Это свойство является только для чтения и постоянным, и его значение равно MenuItemType.Item.

visible : bool

Указывает, должен ли быть виден пункт меню. По умолчанию true.

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

toggled(checked)

Вызывается всякий раз, когда свойство checked пункта меню изменяется. Это обычно происходит одновременно с triggered.

Соответствующий обработчик — onToggled.

См. также checked, triggered, Action::triggered и Action::toggled.

triggered()

Вызывается, когда пункт меню или связанное с ним действие были активированы.

Соответствующий обработчик — onTriggered.

См. также trigger(), Action::triggered и Action::toggled.

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

void trigger()

Вручную активировать пункт меню. Также активирует связанное с элементом действие.

См. также triggered и Action::trigger().