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: |
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()
| Constante | Valor | Descripción |
|---|---|---|
QAction::Trigger | 0 | Esto provocará que se emita la señal « QAction::triggered()». |
QAction::Hover | 1 | Esto provocará que se emita la señal ` QAction::hovered()`. |
enum QAction::MenuRole
Esta enumeración describe cómo debe añadirse una acción al menú de la aplicación en macOS.
| Constante | Valor | Descripción |
|---|---|---|
QAction::NoRole | 0 | Esta acción no debe incluirse en el menú de la aplicación |
QAction::TextHeuristicRole | 1 | Esta 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::ApplicationSpecificRole | 2 | Esta acción debe incluirse en el menú de la aplicación con un rol específico de la aplicación |
QAction::AboutQtRole | 3 | Esta acción gestiona la opción de menú «Acerca de Qt». |
QAction::AboutRole | 4 | Esta 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::PreferencesRole | 5 | Esta acción debe colocarse donde se encuentra la opción de menú «Preferencias...» en el menú de la aplicación. |
QAction::QuitRole | 6 | Esta 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.
| Constante | Valor | Descripción |
|---|---|---|
QAction::LowPriority | 0 | La acción no debe tener prioridad en la interfaz de usuario. |
QAction::NormalPriority | 128 | |
QAction::HighPriority | 256 | La 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().
menuRole : MenuRole
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.
[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.
Nota: Señalde notificación para las propiedades autoRepeat, font, icon, iconText, iconVisibleInMenu, menuRole, priority, shortcut, shortcutContext, shortcutVisibleInContextMenu, statusTip, text, toolTip y whatsThis.
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().
QMenu *QAction::menu() const
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á.
© 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.