QActionGroup Class
La clase QActionGroup agrupa acciones. Más información ...
| Encabezado: | #include <QActionGroup> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Desde: | Qt 6.0 |
| Heredado de: | QObject |
Tipos públicos
| enum class | ExclusionPolicy { None, Exclusive, ExclusiveOptional } |
Propiedades
- enabled : bool
- exclusionPolicy : QActionGroup::ExclusionPolicy
- visible : bool
Funciones públicas
| QActionGroup(QObject *parent) | |
| virtual | ~QActionGroup() |
| QList<QAction *> | actions() const |
| QAction * | addAction(QAction *action) |
| QAction * | addAction(const QString &text) |
| QAction * | addAction(const QIcon &icon, const QString &text) |
| QAction * | checkedAction() const |
| QActionGroup::ExclusionPolicy | exclusionPolicy() const |
| bool | isEnabled() const |
| bool | isExclusive() const |
| bool | isVisible() const |
| void | removeAction(QAction *action) |
Ranuras públicas
| void | setDisabled(bool b) |
| void | setEnabled(bool) |
| void | setExclusionPolicy(QActionGroup::ExclusionPolicy policy) |
| void | setExclusive(bool b) |
| void | setVisible(bool) |
Señales
Descripción detallada
QActionGroup es una clase base para agrupar clases que heredan de objetos de tipo ` QAction `.
En algunas situaciones resulta útil agrupar objetos ` QAction `. Por ejemplo, si tienes una acción ` Left Align `, una acción ` Right Align `, una acción ` Justify ` y una acción ` Center `, solo una de estas acciones debería estar activa en un momento dado. Una forma sencilla de lograrlo es agrupar las acciones en un grupo de acciones que herede de `QActionGroup`.
Véase también QAction.
Documentación sobre tipos de miembros
enum class QActionGroup::ExclusionPolicy
Esta enumeración especifica las diferentes políticas que se pueden utilizar para controlar la forma en que el grupo realiza la comprobación de exclusividad en las acciones comprobables.
| Constante | Valor | Descripción |
|---|---|---|
QActionGroup::ExclusionPolicy::None | 0 | Las acciones del grupo se pueden marcar de forma independiente unas de otras. |
QActionGroup::ExclusionPolicy::Exclusive | 1 | Solo se puede marcar una acción a la vez. Esta es la política predeterminada. |
QActionGroup::ExclusionPolicy::ExclusiveOptional | 2 | Como máximo, se puede marcar una acción a la vez. También es posible desmarcar todas las acciones. |
Véase también exclusionPolicy.
Documentación de propiedades
enabled : bool
Esta propiedad indica si el grupo de acciones está activado
Cada acción del grupo estará habilitada o deshabilitada, salvo que se haya deshabilitado explícitamente.
Funciones de acceso:
| bool | isEnabled() const |
| void | setEnabled(bool) |
Véase también ` QAction::setEnabled()`.
exclusionPolicy : QActionGroup::ExclusionPolicy
Esta propiedad establece la política de verificación exclusiva del grupo
Si exclusionPolicy se establece en «Exclusivo», solo puede estar activa una acción marcable del grupo de acciones en un momento dado. Si el usuario selecciona otra acción marcable del grupo, la que ha elegido pasa a estar activa y la que estaba activa queda inactiva. Si exclusionPolicy está configurada en «ExclusionOptional», el grupo es exclusivo, pero la acción marcable activa del grupo se puede desmarcar, dejando el grupo sin ninguna acción marcada.
Funciones de acceso:
| QActionGroup::ExclusionPolicy | exclusionPolicy() const |
| void | setExclusionPolicy(QActionGroup::ExclusionPolicy policy) |
Véase también QAction::checkable.
visible : bool
Esta propiedad indica si el grupo de acciones está visible
Cada acción del grupo de acciones coincidirá con el estado de visibilidad de este grupo, a menos que se haya ocultado explícitamente.
Funciones de acceso:
| bool | isVisible() const |
| void | setVisible(bool) |
Véase también QAction::setEnabled().
Documentación de las funciones de miembro
[explicit] QActionGroup::QActionGroup(QObject *parent)
Crea un grupo de acciones para el objeto ` parent `.
El grupo de acciones es exclusivo por defecto. Llama a ` setExclusive(false)` para que el grupo de acciones no sea exclusivo. Para que el grupo sea exclusivo pero permita desmarcar la acción activa, llama en su lugar a ` setExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional)`
[virtual noexcept] QActionGroup::~QActionGroup()
Elimina el grupo de acciones.
QList<QAction *> QActionGroup::actions() const
Devuelve la lista de acciones de este grupo. Puede que esté vacía.
QAction *QActionGroup::addAction(QAction *action)
Añade el objeto « action » a este grupo y lo devuelve.
Normalmente, una acción se añade a un grupo creándola con el grupo como padre, por lo que esta función no se suele utilizar.
Véase también QAction::setActionGroup().
QAction *QActionGroup::addAction(const QString &text)
Crea y devuelve una acción con « text ». La acción recién creada es una acción secundaria de este grupo de acciones.
Normalmente, una acción se añade a un grupo creándola con el grupo como padre, por lo que esta función no suele utilizarse.
Véase también QAction::setActionGroup().
QAction *QActionGroup::addAction(const QIcon &icon, const QString &text)
Crea y devuelve una acción con un « text » y un « icon ». La acción recién creada es una acción secundaria de este grupo de acciones.
Normalmente, una acción se añade a un grupo creándola con el grupo como padre, por lo que esta función no se suele utilizar.
Véase también QAction::setActionGroup().
QAction *QActionGroup::checkedAction() const
Devuelve la acción seleccionada actualmente en el grupo, o ` nullptr ` si no hay ninguna seleccionada.
[signal] void QActionGroup::hovered(QAction *action)
Esta señal se emite cuando el usuario selecciona el elemento « action » del grupo de acciones; por ejemplo, cuando el usuario se detiene con el cursor sobre una opción de menú o un botón de la barra de herramientas, o cuando pulsa la combinación de teclas de acceso rápido de una acción.
Véase también QAction::activate().
bool QActionGroup::isExclusive() const
Devuelve «true» si el grupo es exclusivo
El grupo es exclusivo si el parámetro « ExclusionPolicy » tiene el valor «Exclusive» o «ExclusionOptional».
void QActionGroup::removeAction(QAction *action)
Elimina el « action » de este grupo. Como resultado, la acción quedará sin elemento principal.
Véase también ` QAction::setActionGroup()`.
[slot] void QActionGroup::setDisabled(bool b)
Se trata de una función de conveniencia para la propiedad « enabled », que resulta útil para las conexiones entre señales y ranuras. Si « b » es verdadero, el grupo de acciones queda desactivado; en caso contrario, queda activado.
[slot] void QActionGroup::setExclusive(bool b)
Activar o desactivar la comprobación de exclusión de grupos
Se trata de un método de conveniencia que llama a setExclusionPolicy(ExclusionPolicy::Exclusive) cuando b es verdadero; en caso contrario, llama a setExclusionPolicy(QActionGroup::ExclusionPolicy::None).
Véanse también isExclusive() y QActionGroup::exclusionPolicy.
[signal] void QActionGroup::triggered(QAction *action)
Esta señal se emite cuando el usuario activa la acción « action » del grupo de acciones; por ejemplo, cuando el usuario hace clic en una opción de menú o en un botón de la barra de herramientas, o cuando pulsa la combinación de teclas de acceso rápido de una acción.
Conéctate a esta señal para las acciones de comando.
Véase también QAction::activate().
© 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.