En esta página

QAction Class

La clase QAction ofrece una abstracción de los comandos de usuario que se pueden añadir a diferentes componentes de la interfaz de usuario. Más información...

Encabezado: #include <QAction>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Desde: Qt 6.0
Heredado de: QObject
Heredado por:

QWidgetAction

Tipos públicos

enum ActionEvent { Trigger, Hover }
enum MenuRole { NoRole, TextHeuristicRole, ApplicationSpecificRole, AboutQtRole, AboutRole, …, QuitRole }
enum Priority { LowPriority, NormalPriority, HighPriority }

Propiedades

Funciones públicas

QAction(QObject *parent = nullptr)
QAction(const QString &text, QObject *parent = nullptr)
QAction(const QIcon &icon, const QString &text, QObject *parent = nullptr)
virtual ~QAction()
QActionGroup *actionGroup() const
void activate(QAction::ActionEvent event)
(since 6.0) QList<QObject *> associatedObjects() const
bool autoRepeat() const
QVariant data() const
QFont font() const
QIcon icon() const
QString iconText() const
bool isCheckable() const
bool isChecked() const
bool isEnabled() const
bool isIconVisibleInMenu() const
bool isSeparator() const
bool isShortcutVisibleInContextMenu() const
bool isVisible() const
QMenu *menu() const
QAction::MenuRole menuRole() const
QAction::Priority priority() const
void setActionGroup(QActionGroup *group)
void setAutoRepeat(bool)
void setCheckable(bool)
void setData(const QVariant &data)
void setFont(const QFont &font)
void setIcon(const QIcon &icon)
void setIconText(const QString &text)
void setIconVisibleInMenu(bool visible)
void setMenu(QMenu *menu)
void setMenuRole(QAction::MenuRole menuRole)
void setPriority(QAction::Priority priority)
void setSeparator(bool b)
void setShortcut(const QKeySequence &shortcut)
void setShortcutContext(Qt::ShortcutContext context)
void setShortcutVisibleInContextMenu(bool show)
void setShortcuts(QKeySequence::StandardKey key)
void setShortcuts(const QList<QKeySequence> &shortcuts)
void setStatusTip(const QString &statusTip)
void setText(const QString &text)
void setToolTip(const QString &tip)
void setWhatsThis(const QString &what)
QKeySequence shortcut() const
Qt::ShortcutContext shortcutContext() const
QList<QKeySequence> shortcuts() const
bool showStatusText(QObject *object = nullptr)
QString statusTip() const
QString text() const
QString toolTip() const
QString whatsThis() const

Ranuras públicas

void hover()
void resetEnabled()
void setChecked(bool)
void setDisabled(bool b)
void setEnabled(bool)
void setVisible(bool)
void toggle()
void trigger()

Señales

void changed()
void checkableChanged(bool checkable)
void enabledChanged(bool enabled)
void hovered()
void toggled(bool checked)
void triggered(bool checked = false)
void visibleChanged()

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override

Descripción detallada

En las aplicaciones, muchos comandos habituales pueden invocarse a través de menús, botones de la barra de herramientas y atajos de teclado. Dado que el usuario espera que cada comando se ejecute de la misma manera, independientemente de la interfaz de usuario utilizada, resulta útil representar cada comando como una acción.

Las acciones se pueden añadir a elementos de la interfaz de usuario, como menús y barras de herramientas, y mantendrán automáticamente la interfaz sincronizada. Por ejemplo, en un procesador de textos, si el usuario pulsa el botón «Negrita» de la barra de herramientas, la opción «Negrita» del menú quedará marcada automáticamente.

Una QAction puede contener un icono, un texto descriptivo, el texto del icono, un atajo de teclado, un texto de estado, el texto «¿Qué es esto?» y una información sobre herramientas. Todas las propiedades se pueden configurar de forma independiente con setIcon(), setText(), setIconText(), setShortcut(), setStatusTip(), setWhatsThis() y setToolTip(). El icono y el texto, como las dos propiedades más importantes, también se pueden establecer en el constructor. Es posible establecer una fuente concreta con ` setFont()`, que, por ejemplo, los menús respetan al mostrar la acción como elemento de menú.

Recomendamos que las acciones se creen como elementos hijos de la ventana en la que se utilizan. En la mayoría de los casos, las acciones serán elementos hijos de la ventana principal de la aplicación.

QAction en aplicaciones de widgets

Una vez creada una QAction, debe añadirse al menú y a la barra de herramientas correspondientes y, a continuación, conectarse a la ranura que ejecutará la acción.

Las acciones se añaden a los widgets mediante QWidget::addAction() o QGraphicsWidget::addAction(). Ten en cuenta que una acción debe añadirse a un widget antes de poder utilizarse. Esto también es válido cuando el atajo debe ser global (es decir, Qt::ApplicationShortcut como Qt::ShortcutContext).

Las acciones pueden crearse como objetos independientes. Pero también pueden crearse durante la construcción de menús. La clase QMenu contiene funciones prácticas para crear acciones adecuadas para su uso como elementos de menú.

Véase también QMenu y QToolBar.

Documentación sobre tipos de miembros

enum QAction::ActionEvent

Este tipo de enumeración se utiliza al llamar a QAction::activate()

ConstanteValorDescripción
QAction::Trigger0Esto provocará que se emita la señal « QAction::triggered()».
QAction::Hover1Esto provocará que se emita la señal ` QAction::hovered()`.

Esta enumeración describe cómo debe añadirse una acción al menú de la aplicación en macOS.

ConstanteValorDescripción
QAction::NoRole0Esta acción no debe incluirse en el menú de la aplicación
QAction::TextHeuristicRole1Esta acción debe incluirse en el menú de la aplicación según el texto de la acción, tal y como se describe en la documentación de « QMenuBar ».
QAction::ApplicationSpecificRole2Esta acción debe incluirse en el menú de la aplicación con un rol específico de la aplicación
QAction::AboutQtRole3Esta acción gestiona la opción de menú «Acerca de Qt».
QAction::AboutRole4Esta acción debe colocarse donde se encuentra el elemento de menú «Acerca de» en el menú de la aplicación. El texto del elemento de menú se establecerá como «Acerca de <NOMBRE de la aplicación>». El nombre de la aplicación se obtiene del archivo Info.plist del paquete de la aplicación (véase Qt para macOS: Implementación).
QAction::PreferencesRole5Esta acción debe colocarse donde se encuentra la opción de menú «Preferencias...» en el menú de la aplicación.
QAction::QuitRole6Esta acción debe colocarse donde se encuentra la opción de menú «Salir» en el menú de la aplicación.

Establecer este valor solo tiene efecto sobre los elementos que se encuentran en los menús inmediatos de la barra de menús, no en los submenús de dichos menús. Por ejemplo, si tienes el menú «Archivo» en tu barra de menús y este menú tiene un submenú, establecer el MenuRole para las acciones de ese submenú no tendrá ningún efecto. Nunca se moverán.

enum QAction::Priority

Esta enumeración define las prioridades de las acciones en la interfaz de usuario.

ConstanteValorDescripción
QAction::LowPriority0La acción no debe tener prioridad en la interfaz de usuario.
QAction::NormalPriority128 
QAction::HighPriority256La acción debe tener prioridad en la interfaz de usuario.

Véase también priority.

Documentación de la propiedad

autoRepeat : bool

Esta propiedad indica si la acción se puede repetir automáticamente

Si el valor es «true», la acción se repetirá automáticamente mientras se mantenga pulsada la combinación de teclas de acceso rápido, siempre que la repetición automática del teclado esté activada en el sistema. El valor por defecto es «true».

Funciones de acceso:

bool autoRepeat() const
void setAutoRepeat(bool)

Señal de notificación:

void changed()

checkable : bool

Esta propiedad se cumple independientemente de si la acción es una acción conmutable

Una acción conmutable es aquella que tiene un estado activado/desactivado. Por ejemplo, en un procesador de textos, el botón «Negrita» de la barra de herramientas puede estar activado o desactivado. Una acción que no sea conmutable es una acción de comando; una acción de comando simplemente se ejecuta, por ejemplo, «Guardar archivo». Por defecto, esta propiedad es « false ».

En algunas situaciones, el estado de una acción de alternancia debería depender del estado de otras. Por ejemplo, las acciones de conmutación «Alinear a la izquierda», «Centrar» y «Alinear a la derecha» son mutuamente excluyentes. Para lograr una conmutación exclusiva, añade las acciones de conmutación pertinentes a un ` QActionGroup ` con la propiedad `QActionGroup::exclusive` establecida en «true».

Funciones de acceso:

bool isCheckable() const
void setCheckable(bool)

Señal del notificador:

void checkableChanged(bool checkable)

Véase también setChecked().

checked : bool

Esta propiedad indica si la acción está marcada.

Solo se pueden marcar las acciones que permiten ser marcadas. Por defecto, este valor es falso (la acción no está marcada).

Nota: La señal de notificación de esta propiedad es « toggled()». Al activar o desactivar un « QAction », se modifica su estado y, por lo tanto, también se emite la señal « changed()».

Funciones de acceso:

bool isChecked() const
void setChecked(bool)

Señal de notificador:

void toggled(bool checked)

Véase también checkable y toggled().

enabled : bool

Esta propiedad se mantiene independientemente de si la acción está habilitada

El usuario no puede seleccionar las acciones desactivadas. No desaparecen de los menús ni de las barras de herramientas, pero se muestran de forma que se indique que no están disponibles. Por ejemplo, pueden mostrarse utilizando únicamente tonos de gris.

What's This? La ayuda sobre las acciones desactivadas sigue estando disponible, siempre que se haya establecido la propiedad QAction::whatsThis.

Una acción se desactivará cuando todos los widgets a los que se haya añadido (mediante QWidget::addAction()) estén desactivados o no sean visibles. Cuando una acción está desactivada, no es posible activarla mediante su atajo.

Por defecto, esta propiedad es true (las acciones están habilitadas).

Funciones de acceso:

bool isEnabled() const
void setEnabled(bool)
void resetEnabled()

Señal del notificador:

void enabledChanged(bool enabled)

Véase también text.

font : QFont

Esta propiedad define la fuente de la acción

La propiedad «font» se utiliza para representar el texto establecido en « QAction ». La fuente puede considerarse una sugerencia, ya que no se tendrá en cuenta en todos los casos, dependiendo de la aplicación y el estilo.

Por defecto, esta propiedad contiene la fuente predeterminada de la aplicación.

Funciones de acceso:

QFont font() const
void setFont(const QFont &font)

Señal del notificador:

void changed()

Véase también setText().

icon : QIcon

Esta propiedad contiene el icono de la acción

En las barras de herramientas, el icono se utiliza como icono del botón de la herramienta; en los menús, se muestra a la izquierda del texto del menú, siempre que ` QAction::iconVisibleInMenu ` devuelva ` true`.

No hay ningún icono predeterminado.

Si se pasa un icono nulo (QIcon::isNull()) a esta función, se borra el icono de la acción.

Funciones de acceso:

QIcon icon() const
void setIcon(const QIcon &icon)

Señal de notificación:

void changed()

iconText : QString

Esta propiedad contiene el texto descriptivo del icono de la acción

Si QToolBar::toolButtonStyle se establece en un valor que permite mostrar texto, el texto definido en esta propiedad aparece como etiqueta en el botón de herramienta correspondiente.

También sirve como texto predeterminado en los menús y las descripciones emergentes si la acción no se ha definido con ` setText()` o ` setToolTip()`, y se utilizará asimismo en los botones de la barra de herramientas si no se ha definido ningún icono mediante ` setIcon()`.

Si el texto del icono no se establece explícitamente, se utilizará el texto normal de la acción como texto del icono.

Por defecto, esta propiedad contiene una cadena vacía.

Funciones de acceso:

QString iconText() const
void setIconText(const QString &text)

Señal de notificación:

void changed()

Véase también setToolTip() y setStatusTip().

iconVisibleInMenu : bool

Esta propiedad determina si una acción debe mostrar un icono en un menú o no

En algunas aplicaciones, puede tener sentido que las acciones aparezcan con iconos en la barra de herramientas, pero no en los menús. Si el valor es «true», el icono (si es válido) se muestra en el menú; si es «false», no se muestra.

Por defecto, se sigue la configuración del atributo « Qt::AA_DontShowIconsInMenus » de la aplicación. Al establecer explícitamente esta propiedad, se anula la presencia (o ausencia) de dicho atributo.

Por ejemplo:

QApplication app(argc, argv);
app.setAttribute(Qt::AA_DontShowIconsInMenus);  // Icons are *no longer shown* in menus
// ...
QAction *myAction = new QAction();
// ...
myAction->setIcon(SomeIcon);
myAction->setIconVisibleInMenu(true);   // Icon *will* be shown in menus for *this* action.

Funciones de acceso:

bool isIconVisibleInMenu() const
void setIconVisibleInMenu(bool visible)

Señal del notificador:

void changed()

Véase también icon y QCoreApplication::setAttribute().

Esta propiedad define la función del menú de la acción

Esto indica qué función desempeña la acción en el menú de la aplicación en macOS. Por defecto, todas las acciones tienen la función « TextHeuristicRole », lo que significa que la acción se añade en función de su texto (consulta QMenuBar para obtener más información).

La función de menú solo se puede modificar antes de que las acciones se incluyan en la barra de menús de macOS (normalmente, justo antes de que se muestre la primera ventana de la aplicación).

Funciones de acceso:

QAction::MenuRole menuRole() const
void setMenuRole(QAction::MenuRole menuRole)

Señal del notificador:

void changed()

priority : Priority

Esta propiedad indica la prioridad de la acción en la interfaz de usuario.

Esta propiedad se puede configurar para indicar cómo se debe priorizar la acción en la interfaz de usuario.

Por ejemplo, cuando las barras de herramientas tienen activado el modo « Qt::ToolButtonTextBesideIcon », las acciones con la opción « LowPriority » no mostrarán las etiquetas de texto.

Funciones de acceso:

QAction::Priority priority() const
void setPriority(QAction::Priority priority)

Señal de notificación:

void changed()

shortcut : QKeySequence

Esta propiedad contiene la tecla de acceso rápido principal de la acción

Los códigos de teclas válidos para esta propiedad se pueden consultar en Qt::Key y Qt::Modifier. No hay ninguna tecla de acceso rápido predeterminada.

Funciones de acceso:

QKeySequence shortcut() const
void setShortcut(const QKeySequence &shortcut)

Señal de notificación:

void changed()

shortcutContext : Qt::ShortcutContext

Esta propiedad contiene el contexto del atajo de la acción

Los valores válidos para esta propiedad se pueden consultar en Qt::ShortcutContext. El valor por defecto es Qt::WindowShortcut.

Funciones de acceso:

Qt::ShortcutContext shortcutContext() const
void setShortcutContext(Qt::ShortcutContext context)

Señal del notificador:

void changed()

shortcutVisibleInContextMenu : bool

Esta propiedad determina si una acción debe mostrar o no un atajo en un menú contextual

En algunas aplicaciones, puede resultar útil que las acciones del menú contextual incluyan atajos. Si el valor es «true», el atajo (si es válido) se muestra cuando la acción aparece en el menú contextual; si es «false», no se muestra.

Por defecto, se sigue la configuración del atributo « Qt::AA_DontShowShortcutsInContextMenus » de la aplicación. Al establecer esta propiedad de forma explícita, se anula el valor de dicho atributo.

Funciones de acceso:

bool isShortcutVisibleInContextMenu() const
void setShortcutVisibleInContextMenu(bool show)

Señal de notificación:

void changed()

Véase también shortcut y QCoreApplication::setAttribute().

statusTip : QString

Esta propiedad contiene la información de estado de la acción

La indicación de estado se muestra en todas las barras de estado proporcionadas por el widget padre de nivel superior de la acción.

Por defecto, esta propiedad contiene una cadena vacía.

Funciones de acceso:

QString statusTip() const
void setStatusTip(const QString &statusTip)

Señal del notificador:

void changed()

Véase también setToolTip() y showStatusText().

text : QString

Esta propiedad contiene el texto descriptivo de la acción

Si la acción se añade a un menú, la opción del menú estará compuesta por el icono (si lo hay), el texto y el atajo (si lo hay). Si el texto no se establece explícitamente en el constructor, ni mediante setText(), se utilizará como texto la descripción del icono de la acción. No hay ningún texto por defecto.

Ciertos elementos de la interfaz de usuario, como los menús o los botones, pueden utilizar «&» delante de un carácter para crear automáticamente un mnemónico (un atajo) para ese carácter. Por ejemplo, «&Archivo» en un menú creará el atajo Alt+F, que abrirá el menú Archivo. «E&xit» creará el atajo Alt+X para un botón o, en un menú, permitirá acceder a la opción del menú pulsando «x». (Utiliza «&&» para mostrar el símbolo «&» real). El widget puede consumir y ejecutar una acción al pulsar un atajo determinado.

Funciones de acceso:

QString text() const
void setText(const QString &text)

Señal de notificación:

void changed()

Véase también iconText.

toolTip : QString

Esta propiedad contiene la descripción emergente de la acción

Este texto se utiliza para la descripción emergente. Si no se especifica ninguna descripción emergente, se utiliza el texto de la acción.

Por defecto, esta propiedad contiene el texto de la acción.

Funciones de acceso:

QString toolTip() const
void setToolTip(const QString &tip)

Señal del notificador:

void changed()

Véase también setStatusTip() y setShortcut().

visible : bool

Esta propiedad indica si la acción es visible (por ejemplo, en menús y barras de herramientas)

Si «visible» es verdadero, la acción puede verse (por ejemplo, en menús y barras de herramientas) y ser seleccionada por el usuario; si «visible» es falso, la acción no puede verse ni ser seleccionada por el usuario.

Las acciones que no son visibles no aparecen atenuadas; simplemente no aparecen en absoluto.

Por defecto, esta propiedad es « true » (las acciones son visibles).

Funciones de acceso:

bool isVisible() const
void setVisible(bool)

Señal de notificación:

void visibleChanged()

whatsThis : QString

Esta propiedad contiene el texto de ayuda «¿Qué es esto?» de la acción

El texto de «¿Qué es esto?» se utiliza para ofrecer una breve descripción de la acción. El texto puede contener texto con formato. No hay ningún texto predeterminado para «¿Qué es esto?».

Funciones de acceso:

QString whatsThis() const
void setWhatsThis(const QString &what)

Señal de notificación:

void changed()

Véase también QWhatsThis.

Documentación de funciones de miembro

[explicit] QAction::QAction(QObject *parent = nullptr)

Crea una acción con ` parent`. Si ` parent ` es un grupo de acciones, la acción se insertará automáticamente en dicho grupo.

Nota: El argumento parent es opcional desde Qt 5.7.

[explicit] QAction::QAction(const QString &text, QObject *parent = nullptr)

Crea una acción con una « text » y una « parent ». Si « parent » es un grupo de acciones, la acción se insertará automáticamente en dicho grupo.

Se utilizará una versión abreviada de text (por ejemplo, «&Opción de menú...» se convierte en «Opción de menú») para las descripciones emergentes y el texto de los iconos, a menos que se especifique un texto diferente utilizando setToolTip() o setIconText(), respectivamente.

Véase también text.

[explicit] QAction::QAction(const QIcon &icon, const QString &text, QObject *parent = nullptr)

Crea una acción con un « icon » y algunos « text » y « parent ». Si « parent » es un grupo de acciones, la acción se insertará automáticamente en el grupo.

Se utilizará una versión simplificada de text (por ejemplo, «&Opción de menú...» se convierte en «Opción de menú») para las descripciones emergentes y el texto de los iconos, a menos que se especifique un texto diferente mediante setToolTip() o setIconText(), respectivamente.

Véase también text y icon.

[virtual noexcept] QAction::~QAction()

Destruye el objeto y libera los recursos asignados.

QActionGroup *QAction::actionGroup() const

Devuelve el grupo de acciones correspondiente a esta acción. Si ninguna acción gestiona esta acción, se devolverá « nullptr ».

Véase también QActionGroup y setActionGroup().

void QAction::activate(QAction::ActionEvent event)

Envía las señales pertinentes para ActionEvent event .

Los widgets basados en acciones utilizan esta API para hacer que el « QAction » emita señales, además de emitir las suyas propias.

[since 6.0] QList<QObject *> QAction::associatedObjects() const

Devuelve una lista de los objetos a los que se ha añadido esta acción.

Esta función se introdujo en Qt 6.0.

Véase también QWidget::addAction() y QGraphicsWidget::addAction().

[signal] void QAction::changed()

Esta señal se emite cuando se produce un cambio en una acción. Si solo te interesan las acciones de un widget concreto, puedes estar atento a la señal QWidget::actionEvent() enviada con un QEvent::ActionChanged.

Véase también QWidget::actionEvent().

QVariant QAction::data() const

Devuelve los datos de usuario tal y como se han configurado en QAction::setData.

Véase también setData().

[override virtual protected] bool QAction::event(QEvent *e)

Reimplementa: ` QObject::event(QEvent *e)`.

[slot] void QAction::hover()

Se trata de un campo de acceso rápido que llama a la función «activate(Hover)».

[signal] void QAction::hovered()

Esta señal se emite cuando el usuario resalta una acción; 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 activate().

bool QAction::isSeparator() const

Devuelve « true » si esta acción es una acción separadora; en caso contrario, devuelve « false ».

Véase también setSeparator().

Devuelve el menú que contiene esta acción.

En las aplicaciones de widgets, las acciones que contienen menús pueden utilizarse para crear elementos de menú con submenús, o insertarse en barras de herramientas para crear botones con menús emergentes.

Véase también setMenu(), QMenu::addAction() y QMenu::menuInAction().

void QAction::setActionGroup(QActionGroup *group)

Establece este grupo de acciones en « group ». La acción se añadirá automáticamente a la lista de acciones del grupo.

Las acciones del grupo serán mutuamente excluyentes.

Véase también QActionGroup y actionGroup().

void QAction::setData(const QVariant &data)

Establece los datos internos de la acción en el valor proporcionado en « data ».

Véase también data().

[slot] void QAction::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, la acción queda desactivada; en caso contrario, queda activada.

void QAction::setMenu(QMenu *menu)

Establece el menú que contiene esta acción en el menu especificado.

Véase también menu().

void QAction::setSeparator(bool b)

Si « b » es «true», esta acción se considerará un separador.

La forma en que se representa un separador depende del widget en el que se inserte. En la mayoría de los casos, el texto, el submenú y el icono se ignorarán en las acciones de separador.

Véase también isSeparator().

void QAction::setShortcut(const QKeySequence &shortcut)

Establece shortcut como el único atajo que activa la acción.

Nota: Funciónde asignación para la propiedad shortcut.

Véase también shortcut y setShortcuts().

void QAction::setShortcuts(QKeySequence::StandardKey key)

Establece una lista de atajos dependiente de la plataforma basada en key. El resultado de llamar a esta función dependerá de la plataforma en la que se esté ejecutando. Ten en cuenta que con esta acción se puede asignar más de un atajo. Si solo se necesita el atajo principal, utiliza en su lugar setShortcut.

Véanse también shortcuts() y QKeySequence::keyBindings().

void QAction::setShortcuts(const QList<QKeySequence> &shortcuts)

Establece ` shortcuts ` como la lista de atajos que activan la acción. El primer elemento de la lista es el atajo principal.

Véase también shortcut y setShortcut().

QKeySequence QAction::shortcut() const

Devuelve el atajo principal.

Nota: Funcióngetter para la propiedad «shortcut».

Véase también setShortcuts().

QList<QKeySequence> QAction::shortcuts() const

Devuelve la lista de atajos, con el atajo principal como primer elemento de la lista.

Véase también setShortcuts().

bool QAction::showStatusText(QObject *object = nullptr)

Actualiza la barra de estado correspondiente a la interfaz de usuario representada por ` object ` enviando un ` QStatusTipEvent`. Devuelve ` true ` si se ha enviado un evento; en caso contrario, devuelve ` false`.

Si se especifica un widget nulo, el evento se envía al padre de la acción.

Véase también statusTip.

[slot] void QAction::toggle()

Esta es una función de conveniencia para la propiedad « checked ». Conéctate a ella para cambiar el estado «marcado» por su estado opuesto.

[signal] void QAction::toggled(bool checked)

Esta señal se emite cada vez que una acción marcable cambia su estado isChecked(). Esto puede deberse a una interacción del usuario o a que se haya llamado a setChecked(). Dado que setChecked() modifica QAction, emite changed() además de toggled().

checked Es «true» si la acción está marcada, o «false» si no lo está.

Nota: Señalde notificador para la propiedad checked.

Véase también activate(), triggered() y checked.

[slot] void QAction::trigger()

Se trata de una ranura de uso práctico que llama a la función «activate(Trigger)».

[signal] void QAction::triggered(bool checked = false)

Esta señal se emite cuando el usuario activa una acción; por ejemplo, cuando el usuario hace clic en una opción de menú o en un botón de la barra de herramientas, pulsa la combinación de teclas de acceso rápido de una acción, o cuando se llama a la función ` trigger()`. Cabe destacar que no se emite cuando se llaman a las funciones ` setChecked()` o ` toggle()`.

Si la acción es seleccionable, checked es verdadero si la acción está seleccionada, o falso si no lo está.

Véase también activate(), toggled() y checked.

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