En esta página

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

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

void hovered(QAction *action)
void triggered(QAction *action)

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.

ConstanteValorDescripción
QActionGroup::ExclusionPolicy::None0Las acciones del grupo se pueden marcar de forma independiente unas de otras.
QActionGroup::ExclusionPolicy::Exclusive1Solo se puede marcar una acción a la vez. Esta es la política predeterminada.
QActionGroup::ExclusionPolicy::ExclusiveOptional2Como 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.