Action QML Type
Acción abstracta de la interfaz de usuario. Más...
| Import Statement: | import QtQuick.Controls |
| Inherits: |
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
Métodos
Descripción detallada
«Acción» representa una acción abstracta de la interfaz de usuario que puede tener atajos y asignarse a elementos de menú y botones de la barra de herramientas.
Las acciones pueden contener un « text », un « icon » y un « shortcut ». Normalmente, el usuario « triggered » las acciones mediante elementos de menú, botones de la barra de herramientas o atajos de teclado. Una acción « checkable » alterna 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 habitualmente para implementar comandos de la 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, resulta útil representar los comandos como acciones compartibles.
Las acciones también pueden utilizarse para separar la lógica de la presentación visual. Por ejemplo, al declarar botones y elementos de menú en 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 asocia a 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, la opción de menú «Negrita» se marcará automáticamente. Por defecto, los botones y las opciones de menú obtienen sus valores « text » y « icon » de la acción. Se puede anular un valor « text » o « icon » específico de una acción para un control concreto especificando « text » o « icon » directamente en el control.
MenuItem {
id: menuItem
action: copyAction
text: qsTr("&Copy selected Text")
}Dado que «Action» representa una acción de la interfaz de usuario, está pensada para asignarse a un « MenuItem », « ToolButton » o cualquier otro control que herede de « AbstractButton ». Para los atajos de teclado, resulta más adecuado el tipo más sencillo « Shortcut ».
Véase también « MenuItem », « ToolButton » y « Shortcut ».
Documentación de la propiedad
checkable : bool
Esta propiedad indica si la acción es seleccionable. El valor por defecto es « false ».
Una acción marcable alterna entre marcada (activada) y desmarcada (desactivada) cuando se activa.
Véase también checked.
checked : bool
Esta propiedad se mantiene independientemente de si la acción está marcada.
Véase también checkable.
enabled : bool
Esta propiedad indica si la acción está habilitada. El valor predeterminado es « true ».
icon group
icon.cache : bool
icon.color : color
icon.height : int
icon.name : string
icon.source : url
icon.width : int
| Nombre | Descripción |
|---|---|
| nombre | Esta propiedad contiene el nombre del icono que se va a utilizar. El icono se cargará desde el tema de la plataforma. Si se encuentra el icono en el tema, siempre se utilizará, incluso si también se ha establecido « icon.source ». Si no se encuentra el icono, se utilizará en su lugar « icon.source ». Para obtener más información sobre los iconos de los temas, consulta QIcon::fromTheme(). |
| fuente | Esta propiedad contiene el nombre del icono que se va a utilizar. El icono se cargará como una imagen normal. Si se ha establecido « icon.name » y hace referencia a un icono de tema válido, siempre se utilizará este en lugar de la propiedad indicada. |
| anchura | Esta propiedad indica el ancho del icono. El ancho del icono nunca superará este valor, aunque se reducirá cuando sea necesario. |
| altura | Esta propiedad establece la altura del icono. La altura del icono nunca superará este valor, aunque se reducirá cuando sea necesario. |
| color | Esta propiedad indica el color del icono. El icono se tiñe con el color especificado, a menos que el color se establezca en « |
| caché | Esta propiedad especifica si el icono debe almacenarse en caché. El valor predeterminado es «true». Para obtener más información, consulta cache. Esta propiedad se introdujo en QtQuick.Controls 2.13. |
shortcut : keysequence
Esta propiedad contiene el atajo de la acción. La secuencia de teclas puede establecerse como una de las siguientes: « standard keyboard shortcuts » (por ejemplo, « StandardKey.Copy »), o bien puede describirse mediante una cadena que contenga una secuencia de hasta cuatro pulsaciones de teclas necesarias para activar el atajo.
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 Signal
toggled(QtObject source)
Esta señal se emite cuando se activa o desactiva la acción. El argumento « source » identifica el objeto que ha activado o desactivado la acción.
Por ejemplo, si la acción está asignada a una opción de menú y a un botón de la barra de herramientas, la acción se activa o desactiva cuando se activa o desactiva el control, se activa el atajo de teclado o cuando se llama directamente a toggle().
Nota: El controlador correspondiente es onToggled.
triggered(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 una opción de menú y a un botón de la barra de herramientas, la acción se activa al hacer clic en el control, al activar el atajo de teclado o al llamar directamente a ` trigger()`.
Nota: El controlador correspondiente es onTriggered.
Documentación del método
void toggle(QtObject source)
Activa o desactiva la acción y emite un evento ` toggled()` si está habilitada, con un objeto ` source ` opcional definido.
void trigger(QtObject source)
Activa la acción y emite un ` triggered()` si está habilitado, con un objeto ` source ` opcional definido.
© 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.