Тип QML ActionGroup

Группирует действия вместе. Подробнее...

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

Свойства

• actions : список<Действие>
• checkedAction : Действие
• enabled : bool
• exclusive : bool

Присоединенные свойства

• group : ActionGroup

Сигналы

• triggered(Действие action)

Методы

• void addAction(Действие action)
• void removeAction(Действие action)

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

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

Самый простой способ использования ActionGroup — объявление действий как дочерних элементов группы.

ActionGroup {
    id: alignmentGroup

    Action {
        checked: true
        checkable: true
        text: qsTr("Left")
    }

    Action {
        checkable: true
        text: qsTr("Center")
    }

    Action {
        checkable: true
        text: qsTr("Right")
    }
}

В качестве альтернативы, присоединенное свойство group позволяет объявлять действия в другом месте и назначать их определенной группе.

ActionGroup { id: alignmentGroup }

Action {
    checked: true
    checkable: true
    text: qsTr("Left")
    ActionGroup.group: alignmentGroup
}

Action {
    checkable: true
    text: qsTr("Center")
    ActionGroup.group: alignmentGroup
}

Action {
    checkable: true
    text: qsTr("Right")
    ActionGroup.group: alignmentGroup
}

Более сложные случаи использования могут быть обработаны с помощью методов addAction() и removeAction().

См. также Действие и ButtonGroup.

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

[default] actions : список<Действие>

Это свойство содержит список действий в группе.

См. также group.

checkedAction : Действие

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

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

См. также exclusive.

enabled : bool

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

Если это свойство false, то все действия в группе отключены. Если это свойство true, все действия в группе включены, если явно не отключены.

exclusive : bool

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

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

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

В группе без взаимного исключения выделение и снятие выделения действий не влияет на другие действия в группе. Кроме того, значение свойства checkedAction равно null.

Документация по присоединенным свойствам

ActionGroup.group : ActionGroup

Это свойство присоединяет действие к группе действий.

ActionGroup { id: group }

Action {
    checked: true
    text: qsTr("Option A")
    ActionGroup.group: group
}

Action {
    text: qsTr("Option B")
    ActionGroup.group: group
}

См. также actions.

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

triggered(Действие action)

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

Этот сигнал удобен для реализации общего обработчика сигналов для всех действий в одной группе.

ActionGroup {
    onTriggered: console.log("triggered:", action.text)

    Action { text: "First" }
    Action { text: "Second" }
    Action { text: "Third" }
}

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

См. также Action::triggered().

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

void addAction(Действие action)

Добавляет действие action в группу действий.

Примечание: Ручное добавление объектов в группу действий обычно не требуется. Свойство actions и присоединенное свойство group предоставляют удобный и декларативный синтаксис.

См. также actions и group.

void removeAction(Действие action)

Удаляет действие action из группы действий.

Примечание: Ручное удаление объектов из группы действий обычно не требуется. Свойство actions и присоединенное свойство group предоставляют удобный и декларативный синтаксис.

См. также actions и group.