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

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

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• icon
  • icon.color : цвет
  • icon.height : int
  • icon.name : строка
  • icon.source : url
  • icon.width : int
• shortcut : последовательность клавиш
• text : строка

Сигналы

• toggled(source)
• triggered(source)

Методы

• void toggle(source)
• void trigger(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.

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

См. также checked.

checked : bool

Это свойство указывает, помечено ли действие.

См. также checkable.

enabled : bool

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

icon.color : цвет

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

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

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

text : строка

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

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

toggled(source)

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

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

triggered(source)

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

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

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

void toggle(source)

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

void trigger(source)

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