State QML Type
Define las configuraciones de los objetos y las propiedades. Más información...
| Import Statement: | import QtQuick |
Propiedades
Descripción detallada
Un estado es un conjunto de cambios agrupados respecto a la configuración predeterminada.
Todos los elementos tienen un estado predeterminado que define la configuración por defecto de los objetos y los valores de las propiedades. Se pueden definir nuevos estados añadiendo elementos «State» a la propiedad « states », lo que permite a los elementos alternar entre diferentes configuraciones. Estas configuraciones pueden utilizarse, por ejemplo, para aplicar diferentes conjuntos de valores de propiedades o ejecutar diferentes scripts.
El siguiente ejemplo muestra un único « Rectangle ». En el estado predeterminado, el rectángulo es de color negro. En el estado «clicked», un objeto « PropertyChanges » cambia el color del rectángulo a rojo. Al hacer clic dentro del MouseArea, el estado del rectángulo alterna entre el estado predeterminado y el estado «clicado», cambiando así el color del rectángulo entre negro y rojo.
import QtQuick
Rectangle {
id: myRect
width: 100; height: 100
color: "black"
MouseArea {
id: mouseArea
anchors.fill: parent
onClicked: myRect.state == 'clicked' ? myRect.state = "" : myRect.state = 'clicked';
}
states: [
State {
name: "clicked"
PropertyChanges { target: myRect; color: "red" }
}
]
}Obsérvese que el estado predeterminado se indica mediante una cadena vacía («»).
Los estados se suelen utilizar junto con las transiciones para crear animaciones cuando se producen cambios de estado.
Nota: No está permitidoestablecer el estado de un objeto desde otro estado del mismo objeto.
Véase también el ejemplo de Estados, Qt Quick Estados, transiciones y Qt Qml.
Documentación de propiedades
changes : list<Change> [default read-only]
Esta propiedad contiene los cambios que se deben aplicar a este estado
Por defecto, estos cambios se aplican al estado predeterminado. Si el estado hereda de otro estado, los cambios se aplican al estado del que hereda.
extend : string
Esta propiedad contiene el estado del que se deriva este estado.
Cuando un estado se extiende sobre otro, hereda todos los cambios de ese estado.
El estado que se amplía se considera el estado base en lo que respecta a los cambios especificados por el estado que lo amplía.
name : string
Esta propiedad contiene el nombre del estado.
Cada estado debe tener un nombre único dentro de su elemento.
when : bool
Esta propiedad se aplica cuando se debe aplicar el estado.
Debe establecerse en una expresión que se evalúe como « true » cuando se desee que se aplique el estado. Por ejemplo, el siguiente « Rectangle » entra y sale del estado «hidden» cuando se pulsa la tecla « MouseArea »:
Rectangle {
id: myRect
width: 100; height: 100
color: "red"
MouseArea { id: mouseArea; anchors.fill: parent }
states: State {
name: "hidden"; when: mouseArea.pressed
PropertyChanges { target: myRect; opacity: 0 }
}
}Si varios estados de un grupo tienen cláusulas « when » que dan como resultado « true » al mismo tiempo, se aplicará el primer estado que coincida. Por ejemplo, en el siguiente fragmento de código, state1 siempre se seleccionará en lugar de state2 cuando sharedCondition pase a ser true.
© 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.