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

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

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• icon
  • icon.name : строка
  • icon.source : url
  • icon.width : целое число
  • icon.height : целое число
  • 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.

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

См. также 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.