ActionGroup QML Type

Regroupe les actions. Plus d'informations...

Import Statement: import QtQuick.Controls
Inherits:

QtObject

Propriétés

Propriétés rattachées

Signaux

Méthodes

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.

Propriété Documentation

actions : list<Action> [default]

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

Voir également 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 n'est pas 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'actions est activé. La valeur par défaut est true.

Si cette propriété est 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'actions est exclusif. La valeur par défaut est true.

Si cette propriété vaut 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 de la propriété Attached

ActionGroup.group : ActionGroup

Cette propriété permet d'attacher 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 également actions.


Signal Documentation

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" }
}

Remarque : le gestionnaire correspondant est onTriggered.

Voir également Action::triggered().


Documentation de la méthode

void addAction(Action action)

Ajoute une action action au groupe d'actions.

Remarque : l 'ajout manuel d'objets à un groupe d'actions n'est généralement pas nécessaire. Les propriétés actions et group attached fournissent une syntaxe pratique et déclarative.

Voir également actions et group.


void removeAction(Action action)

Supprime un action du groupe d'action.

Remarque : il n'est généralement pas nécessaire de supprimer manuellement des objets d'un groupe d'action. La propriété actions et la propriété group attached fournissent une syntaxe pratique et déclarative.

Voir également actions et group.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.