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

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

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

Свойства

• checkable : bool
• checked : bool
• enabled : bool
• icon
  • icon.name : строка
  • icon.source : url
  • icon.width : int
  • icon.height : int
  • icon.color : цвет
• shortcut : keysequence
• text : строка

Сигналы

• toggled(source)
• triggered(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 : keysequence

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

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

text : строка

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

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

toggled(source)

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

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

triggered(source)

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

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

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

void toggle(QtObject source = null)

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

void trigger(QtObject source = null)

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