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

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

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

Свойства

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

Сигналы

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

Методы

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

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

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

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

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

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

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

checkable : bool

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

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

См. также checked.

checked : bool

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

См. также checkable.

enabled : bool

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

icon.name : строка

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

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

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

text : строка

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

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

toggled(QtObject source)

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

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

triggered(QtObject source)

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

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

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

void toggle(QtObject source = null)

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

void trigger(QtObject source = null)

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