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

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

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")
}

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