Qt Quick Estados
Tipos relacionados
Especifica cómo cambiar los puntos de anclaje de un elemento en un estado | |
Especifica cómo reasignar un elemento a un nuevo padre en un cambio de estado | |
Describe nuevos enlaces de propiedades o valores para un estado | |
Define configuraciones de objetos y propiedades | |
Especifica cómo ejecutar un script en un estado | |
Proporciona soporte integrado de estados para tipos que no sean «Elemento» |
Muchos diseños de interfaz de usuario se basan en estados; las interfaces tienen configuraciones que varían en función del estado actual. Por ejemplo, un semáforo configurará sus indicadores o luces en función de su estado. Mientras se encuentre en el estado « stop », se encenderá la luz roja, mientras que las luces amarilla y verde se apagarán. En el estado « caution », la luz amarilla está encendida, mientras que las demás luces están apagadas.
En QML, los estados son un conjunto de configuraciones de propiedades definidas en un tipo « State ». Las diferentes configuraciones podrían, por ejemplo:
- Mostrar algunos componentes de la interfaz de usuario y ocultar otros
- Presentar diferentes acciones disponibles al usuario
- Iniciar, detener o pausar animaciones
- Ejecutar algún script necesario en el nuevo estado
- Cambiar el valor de una propiedad de un elemento concreto
- Mostrar una vista o pantalla diferente
Todos los objetos basados en « Item » tienen una propiedad « state » y pueden especificar estados adicionales añadiendo nuevos objetos « State » a la propiedad « states » del elemento. Cada estado dentro de un componente tiene un « name » único, siendo una cadena vacía el valor por defecto. Para cambiar el estado actual de un elemento, establece la propiedad « state » con el nombre del estado.
Los objetos que no sean elementos pueden utilizar estados a través del tipo StateGroup.
Creación de estados
Para crear un estado, añada un objeto ` State ` a la propiedad ` states ` del elemento, que contiene una lista de estados para ese elemento.
Un componente de advertencia ` signal ` puede tener dos estados: el estado « NORMAL » y el estado « CRITICAL ». Supongamos que, en el estado « NORMAL », el valor de la propiedad ` color ` de la señal debe ser ` green ` y el indicador de advertencia ` flag ` está desactivado. Por su parte, en el estado « CRITICAL », el valor de la propiedad ` color ` debe ser ` red ` y el indicador está en ` up`. Podemos modelar los estados utilizando el tipo ` State ` y las configuraciones de color e indicador con el tipo ` PropertyChanges `.
Rectangle {
id: signal
width: 200; height: 200
state: "NORMAL"
states: [
State {
name: "NORMAL"
PropertyChanges { signal.color: "green"}
PropertyChanges { flag.state: "FLAG_DOWN"}
},
State {
name: "CRITICAL"
PropertyChanges { signal.color: "red"}
PropertyChanges { flag.state: "FLAG_UP"}
}
]
}El tipo PropertyChanges modificará los valores de las propiedades de los objetos. Se hace referencia a los objetos a través de su identificador (id). También se hace referencia a los objetos externos al componente mediante la propiedad id, como se ilustra con el cambio de propiedad del objeto externo flag.
Además, el estado puede cambiar asignando a la propiedad « state » el estado de la señal correspondiente. Un cambio de estado podría darse en un tipo « MouseArea », asignando un estado diferente cada vez que la señal reciba un clic del ratón.
Rectangle {
id: signalswitch
width: 75; height: 75
color: "blue"
MouseArea {
anchors.fill: parent
onClicked: {
if (signal.state == "NORMAL")
signal.state = "CRITICAL"
else
signal.state = "NORMAL"
}
}
}El tipo «State» no se limita a realizar modificaciones en los valores de las propiedades. También puede:
- Ejecutar algún script utilizando StateChangeScript
- Anular un controlador de señal existente para un objeto mediante PropertyChanges
- Reasignar un « Item » utilizando ParentChange
- Modificar valores de anclaje mediante AnchorChanges
El estado por defecto
Todos los componentes basados en « Item » tienen una propiedad « state » y un estado por defecto. El estado por defecto es la cadena vacía ("") y contiene todos los valores iniciales de las propiedades de un elemento. El estado por defecto resulta útil para gestionar los valores de las propiedades antes de que se produzcan cambios de estado. Al establecer la propiedad « state » en una cadena vacía, se cargará el estado por defecto.
La propiedad « when »
Para mayor comodidad, el tipo ` State ` dispone de una propiedad ` when ` que puede vincularse a expresiones para cambiar el estado siempre que la expresión vinculada se evalúe como ` true`. La propiedad ` when ` restablecerá el estado predeterminado cuando la expresión se evalúe como falso.
Rectangle {
id: bell
width: 75; height: 75
color: "yellow"
states: State {
name: "RINGING"
when: (signal.state == "CRITICAL")
PropertyChanges {speaker.play: "RING!"}
}
}El componente bell pasará al estado RINGING siempre que signal.state sea CRITICAL.
Animación de los cambios de estado
Los cambios de estado provocan cambios bruscos en los valores. El tipo « Transition » permite cambios más suaves durante los cambios de estado. En las transiciones, se pueden definir animaciones y comportamientos de interpolación. El artículo «Animación y transiciones» contiene más información sobre cómo crear animaciones de estado.
El ejemplo «Animación» muestra cómo declarar un conjunto básico de estados y aplicar transiciones animadas entre ellos.
El artículo«Uso de comportamientos de « Qt Quick » con estados» explica un problema habitual al utilizar comportamientos para animar cambios de estado.
Avance rápido de estados
Para que «Transición» anime correctamente los cambios de estado, a veces es necesario que el motor avance y retroceda rápidamente por un estado (es decir, que establezca y desactive internamente el estado) antes de que se aplique definitivamente. El proceso es el siguiente:
- Se avanza rápidamente en el estado para determinar el conjunto completo de valores finales.
- Se rebobina el estado.
- El estado se aplica por completo, con transiciones.
En algunos casos, esto puede provocar un comportamiento no deseado. Por ejemplo, un estado que cambie el modelo de una vista o el `sourceComponent` de un Loader establecerá estas propiedades varias veces (para aplicarlas, rebobinarlas y, a continuación, volver a aplicarlas), lo que puede resultar relativamente costoso.
El avance rápido del estado debe considerarse un detalle de implementación y puede cambiar en versiones posteriores.
© 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.