ActionGroup QML Type

Regroupe les actions. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• actions : list<Action>
• checkedAction : Action
• enabled : bool
• exclusive : bool

Propriétés rattachées

• group : ActionGroup

Signaux

• triggered(Action action)

Méthodes

• void addAction(Action action)
• void removeAction(Action action)

Description détaillée

ActionGroup est un groupe non visuel d'actions. Un groupe d'actions exclusive mutuel est utilisé pour les actions dont une seule des options peut être sélectionnée à la fois.

La manière la plus directe d'utiliser ActionGroup est de déclarer des actions comme enfants du groupe.

ActionGroup {
    id: alignmentGroup

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

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

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

Par ailleurs, la propriété group attached permet de déclarer les actions ailleurs et de les affecter à un groupe spécifique.

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
}

Des cas d'utilisation plus avancés peuvent être traités à l'aide des méthodes addAction() et removeAction().

Voir également Action et ButtonGroup.

Documentation sur les propriétés

actions : list<Action> [default]

Cette propriété contient la liste des actions du groupe.

Voir aussi group.

checkedAction : Action

Cette propriété contient l'action actuellement sélectionnée dans un groupe exclusif, ou null s'il n'y en a pas ou si le groupe est non exclusif.

Par défaut, il s'agit de la première action cochée ajoutée à un groupe d'actions exclusif.

Voir également exclusive.

enabled : bool

Cette propriété indique si le groupe d'action est activé. La valeur par défaut est true.

Si cette propriété vaut false, toutes les actions du groupe sont désactivées. Si cette propriété vaut true, toutes les actions du groupe sont activées, sauf si elles sont explicitement désactivées.

exclusive : bool

Cette propriété indique si le groupe d'action est exclusif. La valeur par défaut est true.

Si la valeur de cette propriété est true, une seule action du groupe peut être vérifiée à un moment donné. L'utilisateur peut déclencher n'importe quelle action pour la vérifier, et cette action remplacera l'action existante en tant qu'action vérifiée dans le groupe.

Dans un groupe exclusif, l'utilisateur ne peut pas décocher l'action actuellement cochée en la déclenchant ; à la place, une autre action du groupe doit être déclenchée pour définir la nouvelle action cochée pour ce groupe.

Dans un groupe non exclusif, le fait de cocher ou de décocher des actions n'affecte pas les autres actions du groupe. De plus, la valeur de la propriété checkedAction est null.

Documentation sur les propriétés attachées

ActionGroup.group : ActionGroup

Cette propriété rattache une action à un groupe d'actions.

ActionGroup { id: group }

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

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

Voir aussi actions.

Documentation sur les signaux

triggered(Action action)

Ce signal est émis lorsqu'une action action du groupe a été déclenchée.

Ce signal est pratique pour mettre en œuvre un gestionnaire de signal commun pour toutes les actions d'un même groupe.

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

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

Voir aussi Action::triggered().

Documentation de la méthode

void addAction(Action action)

Ajoute une adresse action au groupe d'action.

Voir également actions et group.

void removeAction(Action action)

Supprime un action du groupe d'action.

Voir également actions et group.