En esta página

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.

Item {
    states: [
        State { name: "state1"; when: sharedCondition },
        State { name: "state2"; when: sharedCondition }
    ]
    // ...
}

© 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.