Тип действия QML

Абстрактное действие пользовательского интерфейса. Подробнее...

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• icon
  • icon.cache : bool
  • icon.color : цвет
  • icon.height : int
  • icon.name : строка
  • icon.source : url
  • icon.width : int
• shortcut : keysequence
• text : строка

Сигналы

• toggled(QtObject source)
• triggered(QtObject source)

Методы

• void toggle(QtObject source)
• void trigger(QtObject source)

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

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

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

Action {
    id: copyAction
    text: qsTr("&Copy")
    icon.name: "edit-copy"
    shortcut: StandardKey.Copy
    onTriggered: window.activeFocusItem.copy()
}

Действие обычно используется для реализации команд приложения, которые могут вызываться через элементы меню, кнопки панели инструментов и ярлыки клавиатуры. Поскольку пользователь ожидает, что команды будут выполняться одинаково независимо от используемого пользовательского интерфейса, полезно представлять команды как общие действия.

Действие также может использоваться для разделения логики и визуального представления. Например, при объявлении кнопок и элементов меню в файлах .ui.qml, действия могут быть объявлены в другом месте и назначены извне.

ToolButton {
    id: toolButton
    action: copyAction
}

Когда действие сопоставлено с кнопками и элементами меню, состояния enabled, checkable, и checked синхронизируются автоматически. Например, в текстовом редакторе, если пользователь щелкает по кнопке «Жирный» на панели инструментов, элемент меню «Жирный» автоматически будет выбран. Кнопки и элементы меню получают text и icon из действия по умолчанию. Действие, специфичное для действия text или icon может быть переопределено для определенного элемента управления, указав text или icon непосредственно в элементе управления.

MenuItem {
    id: menuItem
    action: copyAction
    text: qsTr("&Copy selected Text")
}

Поскольку Действие представляет собой действие пользовательского интерфейса, оно предназначено для назначения элементу MenuItem, ToolButton или любому другому элементу управления, наследующему AbstractButton. Для ярлыков клавиатуры более уместен более простой тип Shortcut.

См. также MenuItem, ToolButton и Shortcut.

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

checkable : bool

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

Действие с опцией выбора переключается между выбранным (включено) и невыбранным (выключено) при вызове.

См. также checked.

checked : bool

Это свойство указывает, выбрано ли действие.

См. также checkable.

enabled : bool

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

icon.cache : bool

shortcut : keysequence

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

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

text : string

Это свойство содержит текстовое описание действия.

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

toggled(QtObject source)

Этот сигнал отправляется при переключении действия. Аргумент source идентифицирует объект, который переключил действие.

Например, если действие назначено элементу меню и кнопке панели инструментов, действие переключается, когда элемент управления переключается, активируется ярлык или когда вызывается toggle() непосредственно.

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

triggered(QtObject source)

Этот сигнал отправляется при вызове действия. Аргумент source идентифицирует объект, который вызвал действие.

Например, если действие назначено элементу меню и кнопке панели инструментов, действие вызывается при щелчке элемента управления, активации ярлыка или при непосредственном вызове trigger().

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

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

void toggle(QtObject source)

Переключает действие и отправляет toggled() при разрешении, с необязательным объектом source.

void trigger(QtObject source)

Вызывает действие и отправляет triggered() при разрешении, с необязательным объектом source.