State QML Type

개체 및 속성의 구성을 정의합니다. 자세히...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• changes : list<Change>
• extend : string
• name : string
• when : bool

상세 설명

상태는 기본 구성에서 일괄적으로 변경된 집합입니다.

모든 항목에는 개체 및 속성 값의 기본 구성을 정의하는 기본 상태가 있습니다. states 속성에 상태 항목을 추가하여 새 상태를 정의하면 항목이 서로 다른 구성 간에 전환할 수 있습니다. 예를 들어 이러한 구성을 사용하여 다른 속성 값 집합을 적용하거나 다른 스크립트를 실행할 수 있습니다.

다음 예는 단일 Rectangle 을 표시합니다. 기본 상태에서는 사각형이 검은색으로 표시됩니다. "클릭" 상태에서는 PropertyChanges 개체가 사각형의 색상을 빨간색으로 변경합니다. MouseArea 내부를 클릭하면 사각형의 상태가 기본 상태와 "클릭됨" 상태 간에 전환되므로 사각형의 색상이 검은색과 빨간색 간에 전환됩니다.

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" }
        }
    ]
}

기본 상태는 빈 문자열("")을 사용하여 참조된다는 점에 유의하세요.

상태는 일반적으로 상태 변경 시 애니메이션을 제공하기 위해 트랜지션과 함께 사용됩니다.

상태 예제, Qt Quick 상태, 트랜지션 및 Qt Qml.

속성 문서

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 }
    }
}

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