QAction Class

Documentación de propiedades

autoRepeat : bool

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

Si es true, la acción se repetirá automáticamente cuando se mantenga pulsada la combinación de teclas, siempre que la repetición automática de teclado esté habilitada en el sistema. El valor por defecto es true.

Funciones de acceso:

Señal del notificador:

checkable : bool

Esta propiedad indica si la acción es comprobable.

Una acción comprobable es aquella que tiene un estado activado/desactivado. Por ejemplo, en un procesador de textos, un botón de la barra de herramientas Negrita puede estar activado o desactivado. Una acción que no es una acción 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 depende del estado de otras. Por ejemplo, las acciones "Alinear a la izquierda", "Centrar" y "Alinear a la derecha" son mutuamente excluyentes. Para conseguir una alternancia exclusiva, añade las acciones de alternancia relevantes a QActionGroup con la propiedad QActionGroup::exclusive establecida a true.

Funciones de acceso:

Señal del notificador:

Véase también setChecked().

checked : bool

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

Sólo las acciones verificables pueden ser verificadas. Por defecto, es false (la acción no está marcada).

Funciones de acceso:

Señal notificadora:

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

enabled : bool

Esta propiedad indica si la acción está habilitada

Las acciones deshabilitadas no pueden ser elegidas por el usuario. No desaparecen de los menús o barras de herramientas, pero se muestran de una forma que indica que no están disponibles. Por ejemplo, pueden mostrarse sólo en tonos grises.

What's This? La ayuda para las acciones desactivadas sigue estando disponible, siempre que la propiedad QAction::whatsThis esté activada.

Una acción estará desactivada cuando todos los widgets a los que se añada (con QWidget::addAction()) estén desactivados o no sean visibles. Cuando una acción está desactivada, no es posible activarla a través de su acceso directo.

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

Funciones de acceso:

Señal del notificador:

Véase también text.

font : QFont

Esta propiedad contiene la fuente de la acción

La propiedad font se utiliza para renderizar el texto establecido en QAction. El font puede considerarse una sugerencia ya que no se consultará en todos los casos en función de la aplicación y el estilo.

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

Funciones de acceso:

Señal del notificador:

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 herramienta; en los menús, se muestra a la izquierda del texto del menú, siempre que QAction::iconVisibleInMenu devuelva true.

No existe un icono por defecto.

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

Funciones de acceso:

Señal del notificador:

iconText : QString

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

Si QToolBar::toolButtonStyle tiene un valor que permite mostrar texto, el texto definido en esta propiedad aparecerá como etiqueta en el botón de la herramienta correspondiente.

También sirve como texto por defecto en menús y tooltips si la acción no se ha definido con setText() o setToolTip(), y también se utilizará en los botones de la barra de herramientas si no se ha definido ningún icono utilizando setIcon().

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

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

Funciones de acceso:

Señal del notificador:

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

iconVisibleInMenu : bool

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

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

El valor predeterminado es seguir si el atributo Qt::AA_DontShowIconsInMenus está establecido para la aplicación. La configuración explícita de esta propiedad anula la presencia (o ausencia) del 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:

Señal de notificador:

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

menuRole : MenuRole

Esta propiedad contiene el rol de menú de la acción

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

El rol de menú sólo puede cambiarse antes de que las acciones se coloquen en la barra de menú en macOS (normalmente justo antes de que se muestre la primera ventana de la aplicación).

Funciones de acceso:

Señal de notificador:

priority : Priority

Esta propiedad contiene la prioridad de las acciones en la interfaz de usuario.

Esta propiedad puede establecerse para indicar cómo debe priorizarse la acción en la interfaz de usuario.

Por ejemplo, cuando las barras de herramientas tienen configurado el modo Qt::ToolButtonTextBesideIcon, las acciones con LowPriority no mostrarán las etiquetas de texto.

Funciones de acceso:

Señal del notificador:

shortcut : QKeySequence

Esta propiedad contiene el atajo de teclado principal de la acción.

Los códigos clave válidos para esta propiedad se encuentran en Qt::Key y Qt::Modifier. No existe una tecla de acceso directo por defecto.

Funciones de acceso:

Señal del notificador:

shortcutContext : Qt::ShortcutContext

Esta propiedad contiene el contexto para el acceso directo de la acción

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

Funciones de acceso:

Señal del notificador:

shortcutVisibleInContextMenu : bool

Esta propiedad mantiene si una acción debe o no mostrar un acceso directo en un menú contextual

En algunas aplicaciones, puede tener sentido tener acciones con atajos en menús contextuales. Si es true, el atajo (si es válido) se muestra cuando la acción se muestra a través de un menú contextual, cuando es false, no se muestra.

El valor predeterminado es seguir si el atributo Qt::AA_DontShowShortcutsInContextMenus está establecido para la aplicación. Establecer explícitamente esta propiedad anula el atributo.

Funciones de acceso:

Señal del notificador:

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

statusTip : QString

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

La informació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:

Señal del notificador:

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 de menú consistirá en el icono (si lo hay), el texto y el acceso directo (si lo hay). Si el texto no se establece explícitamente en el constructor, o utilizando setText(), se utilizará como texto el texto del icono descriptivo de la acción. No hay texto por defecto.

Ciertos elementos de la interfaz de usuario, como menús o botones, pueden utilizar '&' delante de un carácter para crear automáticamente un mnemotécnico (un atajo) para ese carácter. Por ejemplo, "&Archivo" para un menú creará el atajo Alt+F, que abrirá el menú Archivo. "E&Salir" creará el acceso directo Alt+X para un botón, o en un menú permitirá navegar hasta el elemento del menú pulsando "x". (utiliza "&&" para mostrar un ampersand real). El widget puede consumir y realizar una acción en un acceso directo dado.

Funciones de acceso:

Señal del notificador:

Véase también iconText.

toolTip : QString

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

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

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

Funciones de acceso:

Señal del notificador:

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

visible : bool

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

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

Las acciones que no son visibles no aparecen en gris, sino que no aparecen en absoluto.

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

Funciones de acceso:

Señal del notificador:

whatsThis : QString

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

El texto "¿Qué es esto?" se utiliza para proporcionar una breve descripción de la acción. El texto puede contener texto enriquecido. No hay texto "¿Qué es esto?" por defecto.

Funciones de acceso:

Señal del notificador:

Véase también QWhatsThis.