Тип QML MenuItem

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

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

Свойства

• action : 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, Menu, MenuSeparator и Action.

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

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. Все элементы меню, использующие одну и ту же группу исключения, а также любые Action, использующие её, становятся взаимно исключительными для выбора, что означает, что только последний отмеченный элемент меню будет фактически отмечен.

По умолчанию 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().