En esta página

ActionGroup QML Type

Agrupa acciones. Más...

Import Statement: import QtQuick.Controls
Inherits:

QtObject

Propiedades

Propiedades adjuntas

Señales

Métodos

Descripción detallada

ActionGroup es un grupo de acciones no visual. Un grupo de acciones mutuamente e exclusive es se utiliza con acciones en las que solo se puede seleccionar una de las opciones a la vez.

La forma más sencilla de utilizar ActionGroup es declarar las acciones como elementos secundarios del grupo.

ActionGroup {
    id: alignmentGroup

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

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

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

Como alternativa, la propiedad adjunta « group » permite declarar las acciones en otro lugar y asignarlas a un grupo específico.

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
}

Los casos de uso más avanzados se pueden gestionar mediante los métodos ` addAction() ` y ` removeAction() `.

Véase también Action y ButtonGroup.

Documentación de la propiedad

actions : list<Action> [default]

Esta propiedad contiene la lista de acciones del grupo.

Véase también group.

checkedAction : Action

Esta propiedad contiene la acción seleccionada actualmente en un grupo exclusivo, o « null » si no hay ninguna o si el grupo no es exclusivo.

Por defecto, es la primera acción marcada que se añade a un grupo de acciones exclusivo.

Véase también « exclusive ».

enabled : bool

Esta propiedad indica si el grupo de acciones está habilitado. El valor por defecto es « true ».

Si esta propiedad es « false », todas las acciones del grupo estarán desactivadas. Si esta propiedad es « true », todas las acciones del grupo estarán activadas, salvo que se hayan desactivado explícitamente.

exclusive : bool

Esta propiedad indica si el grupo de acciones es exclusivo. El valor por defecto es « true ».

Si esta propiedad es « true », solo se puede marcar una acción del grupo en un momento dado. El usuario puede activar cualquier acción para marcarla, y esa acción sustituirá a la existente como acción marcada en el grupo.

En un grupo exclusivo, el usuario no puede desmarcar la acción actualmente marcada activándola; en su lugar, debe activarse otra acción del grupo para establecer la nueva acción marcada para ese grupo.

En un grupo no exclusivo, marcar y desmarcar acciones no afecta a las demás acciones del grupo. Además, el valor de la propiedad « checkedAction » es « null ».

Documentación de la propiedad adjunta

ActionGroup.group : ActionGroup [attached]

Esta propiedad asocia una acción a un grupo de acciones.

ActionGroup { id: group }

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

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

Véase también actions.

Documentación de Signal

triggered(Action action)

Esta señal se emite cuando se ha activado una acción « action » del grupo.

Esta señal resulta útil para implementar un controlador de señales común para todas las acciones del mismo grupo.

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

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

Nota: El controlador correspondiente es onTriggered.

Véase también Action::triggered().

Documentación del método

void addAction(Action action)

Añade un objeto de tipo « action » al grupo de acciones.

Nota: Normalmente no es necesario añadir objetosmanualmente a un grupo de acciones. La propiedad « actions » y la propiedad adjunta « group » proporcionan una sintaxis cómoda y declarativa.

Véase también actions y group.

void removeAction(Action action)

Elimina un objeto « action » del grupo de acciones.

Nota: Por lo general, no es necesario eliminarmanualmente objetos de un grupo de acciones. La propiedad « actions » y la propiedad adjunta « group » proporcionan una sintaxis cómoda y declarativa.

Véase también actions y group.

© 2026 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.