Action QML Type

Acción abstracta de la interfaz de usuario. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• checkable : bool
• checked : bool
• enabled : bool
• icon
  • icon.cache : bool
  • icon.color : color
  • icon.height : int
  • icon.name : string
  • icon.source : url
  • icon.width : int
• shortcut : keysequence
• text : string

Señales

• toggled(QtObject source)
• triggered(QtObject source)

Métodos

• void toggle(QtObject source)
• void trigger(QtObject source)

Descripción detallada

Action representa una acción abstracta de la interfaz de usuario que puede tener accesos directos y puede asignarse a elementos de menú y botones de la barra de herramientas.

Las acciones pueden contener text, un icon, y un shortcut. Las acciones son normalmente triggered por el usuario a través de elementos de menú, botones de la barra de herramientas o atajos de teclado. Una acción checkable cambia su estado checked cuando se activa.

Action {
    id: copyAction
    text: qsTr("&Copy")
    icon.name: "edit-copy"
    shortcut: StandardKey.Copy
    onTriggered: window.activeFocusItem.copy()
}

Las acciones se utilizan normalmente para implementar comandos de aplicación que pueden invocarse a través de elementos de menú, botones de la barra de herramientas y atajos de teclado. Dado que el usuario espera que los comandos se ejecuten de la misma manera, independientemente de la interfaz de usuario utilizada, es útil representar los comandos como acciones compartibles.

Las acciones también pueden utilizarse para separar la lógica y la presentación visual. Por ejemplo, al declarar botones y elementos de menú en los archivos .ui.qml, las acciones pueden declararse en otro lugar y asignarse desde el exterior.

ToolButton {
    id: toolButton
    action: copyAction
}

Cuando una acción se empareja con botones y elementos de menú, los estados enabled, checkable y checked se sincronizan automáticamente. Por ejemplo, en un procesador de textos, si el usuario hace clic en el botón "Negrita" de la barra de herramientas, el elemento de menú "Negrita" se marcará automáticamente. Por defecto, los botones y los elementos de menú obtienen sus text y icon de la acción. Una acción específica text o icon puede ser anulada para un control específico especificando text o icon directamente en el control.

MenuItem {
    id: menuItem
    action: copyAction
    text: qsTr("&Copy selected Text")
}

Dado que Action presenta una acción de interfaz de usuario, está pensada para ser asignada a un MenuItem, ToolButton, o cualquier otro control que herede AbstractButton. Para los métodos abreviados de teclado, es más apropiado el tipo más sencillo Shortcut.

Véase también MenuItem, ToolButton, y Shortcut.

Documentación de propiedades

checkable : bool

Esta propiedad indica si la acción es comprobable. El valor por defecto es false.

Una acción comprobable cambia entre marcada (on) y desmarcada (off) cuando se activa.

Véase también checked.

checked : bool

Esta propiedad indica si se comprueba la acción.

Véase también checkable.

enabled : bool

Esta propiedad indica si la acción está habilitada. El valor por defecto es true.

icon group

shortcut : keysequence

Esta propiedad contiene el atajo de teclado de la acción. La secuencia de teclas puede establecerse en uno de los standard keyboard shortcuts, o puede describirse con una cadena que contenga una secuencia de hasta cuatro pulsaciones de teclas necesarias para activar el acceso directo.

Action {
    shortcut: "Ctrl+E,Ctrl+W"
    onTriggered: edit.wrapMode = TextEdit.Wrap
}

text : string

Esta propiedad contiene una descripción textual de la acción.

Documentación de la señal

toggled(QtObject source)

Esta señal se emite cuando se activa la acción. El argumento source identifica el objeto que ha activado la acción.

Por ejemplo, si la acción está asignada a un elemento de menú y a un botón de la barra de herramientas, la acción se activa cuando se mueve el control, se activa el acceso directo o cuando se llama directamente a toggle().

triggered(QtObject source)

Esta señal se emite cuando se desencadena la acción. El argumento source identifica el objeto que desencadena la acción.

Por ejemplo, si la acción se asigna a un elemento del menú y a un botón de la barra de herramientas, la acción se desencadena cuando se hace clic en el control, se activa el acceso directo o cuando se llama directamente a trigger().

Documentación del método

void toggle(QtObject source)

Activa la acción y emite toggled() si está activada, con un objeto source opcional definido.

void trigger(QtObject source)

Dispara la acción y emite triggered() si está activado, con un objeto source opcional definido.