ActionGroup QML Type
Agrupa acciones. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
Propiedades
- actions : list<Action>
- checkedAction : Action
- enabled : bool
- exclusive : bool
Propiedades adjuntas
- group : ActionGroup
Señales
- triggered(Action action)
Métodos
- void addAction(Action action)
- void removeAction(Action action)
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.
© 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.