QActionGroup Class
La clase QActionGroup agrupa acciones. Más...
| Cabecera: | #include <QActionGroup> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Desde: | Qt 6.0 |
| Hereda: | 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 objetos de QAction.
En algunas situaciones es ú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, sólo una de estas acciones debería estar activa en un momento dado. Una forma sencilla de conseguirlo es agrupar las acciones en un grupo de acciones, heredero de QActionGroup.
Véase también QAction.
Documentación de tipos de miembros
enum class QActionGroup::ExclusionPolicy
Este enum especifica las diferentes políticas que se pueden utilizar para controlar cómo realiza el grupo la comprobación exclusiva de las acciones comprobables.
| Constante | Valor | Descripción |
|---|---|---|
QActionGroup::ExclusionPolicy::None | 0 | Las acciones del grupo se pueden comprobar independientemente unas de otras. |
QActionGroup::ExclusionPolicy::Exclusive | 1 | Sólo se puede comprobar una acción a la vez. Esta es la política por defecto. |
QActionGroup::ExclusionPolicy::ExclusiveOptional | 2 | Se puede comprobar como máximo una acción a la vez. También se pueden desmarcar todas las acciones. |
Véase también exclusionPolicy.
Documentación de propiedades
enabled : bool
Esta propiedad indica si el grupo de acciones está habilitado
Cada acción del grupo estará habilitada o deshabilitada a menos 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 contiene la política de comprobación exclusiva del grupo
Si exclusionPolicy se establece como Exclusive, sólo una acción comprobable en el grupo de acciones puede estar activa en cualquier momento. Si el usuario elige otra acción comprobable en el grupo, la que eligió pasa a estar activa y la que estaba activa pasa a estar inactiva. Si exclusionPolicy se establece en ExclusionOptional, el grupo es exclusivo pero la acción comprobable activa en el grupo puede desmarcarse dejando el grupo sin acciones marcadas.
Funciones de acceso:
| QActionGroup::ExclusionPolicy | exclusionPolicy() const |
| void | setExclusionPolicy(QActionGroup::ExclusionPolicy policy) |
Véase también QAction::checkable.
visible : bool
Esta propiedad mantiene si el grupo de acciones es visible
Cada acción del grupo de acciones coincidirá con el estado visible 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 miembro
[explicit] QActionGroup::QActionGroup(QObject *parent)
Crea un grupo de acciones para el objeto parent.
El grupo de acciones es exclusivo por defecto. Llame a setExclusive(false) para hacer que el grupo de acciones no sea exclusivo. Para que el grupo sea exclusivo pero permita desmarcar la acción activa, llame en su lugar a setExclusionPolicy(QActionGroup::ExclusionPolicy::ExclusiveOptional)
[virtual noexcept] QActionGroup::~QActionGroup()
Destruye el grupo de acción.
QList<QAction *> QActionGroup::actions() const
Devuelve la lista de acciones de este grupo. Puede estar vacía.
QAction *QActionGroup::addAction(QAction *action)
Añade action a este grupo y lo devuelve.
Normalmente, una acción se añade a un grupo creándolo con el grupo como padre, por lo que esta función no suele utilizarse.
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 hija de este grupo de acciones.
Normalmente, una acción se añade a un grupo creándolo 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 text y un icon. La acción recién creada es hija de este grupo de acciones.
Normalmente, una acción se añade a un grupo creándolo con el grupo como padre, por lo que esta función no suele utilizarse.
Véase también QAction::setActionGroup().
QAction *QActionGroup::checkedAction() const
Devuelve la acción actualmente marcada en el grupo, o nullptr si no hay ninguna marcada.
[signal] void QActionGroup::hovered(QAction *action)
Esta señal se emite cuando el usuario resalta el action dado en el 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 pulsa la combinación de teclas de acceso directo 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 ExclusionPolicy es Exclusive o ExclusionOptional.
void QActionGroup::removeAction(QAction *action)
Elimina la dirección action de este grupo. La acción no tendrá ningún padre como resultado.
Véase también QAction::setActionGroup().
[slot] void QActionGroup::setDisabled(bool b)
Esta es una función de conveniencia para la propiedad enabled, que es útil para las conexiones señales-ranuras. Si b es verdadero, el grupo de acciones está deshabilitado; en caso contrario, está habilitado.
[slot] void QActionGroup::setExclusive(bool b)
Activar o desactivar la comprobación de exclusión de grupo
Este es un método conveniente que llama a setExclusionPolicy(ExclusionPolicy::Exclusive) cuando b es verdadero, si no setExclusionPolicy(QActionGroup::ExclusionPolicy::None).
Véase también isExclusive() y QActionGroup::exclusionPolicy.
[signal] void QActionGroup::triggered(QAction *action)
Esta señal se emite cuando el usuario activa el action dado en el grupo de acciones; por ejemplo, cuando el usuario hace clic en una opción del menú o en un botón de la barra de herramientas, o pulsa una combinación de teclas de acceso directo de una acción.
Conéctese 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.