Тип действия 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 : последовательность_клавиш
• text : строка

Сигналы

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

Методы

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

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

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

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

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

См. также Элемент меню, Кнопка панели инструментов и Ярлык.

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

checkable : bool

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

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

См. также checked.

checked : bool

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

См. также checkable.

enabled : bool

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

icon.cache : bool

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

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

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

text : строка

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

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

toggled(QtObject source)

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

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

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

triggered(QtObject source)

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

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

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

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

void toggle(QtObject source)

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

void trigger(QtObject source)

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