Тип QML MenuItem

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

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

Свойства

• action : Action
• checkable : bool
• checked : bool
• enabled : bool
• exclusiveGroup : ExclusiveGroup
• iconName : строка
• iconSource : url
• shortcut : keysequence
• 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 : 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 : keysequence

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

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

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.

Примечание: Соответствующий обработчик onToggled.

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

triggered()

Используется при активации пункта меню или связанного с ним действия.

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

Примечание: Соответствующий обработчик onTriggered.

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

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

void trigger()

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

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