PropertyChanges QML Type

상태에 대한 새 프로퍼티 바인딩 또는 값을 설명합니다. 더 보기...

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

속성

• explicit : bool
• restoreEntryValues : bool
• target : QtObject

상세 설명

PropertyChanges는 State 에서 속성 값 또는 바인딩을 정의하는 데 사용됩니다. 이렇게 하면 상태가 변경될 때 항목의 속성 값을 변경할 수 있습니다.

PropertyChanges 개체를 만들려면 로컬 프로퍼티에 바인딩하는 것처럼 대상 항목의 프로퍼티에 바인딩합니다. 이렇게 하면 새 속성 값이나 바인딩을 정의할 수 있습니다. 예를 들어

import QtQuick

Item {
    id: container
    width: 300; height: 300

    Rectangle {
        id: rect
        width: 100; height: 100
        color: "red"

        MouseArea {
           id: mouseArea
           anchors.fill: parent
        }

        states: State {
           name: "resized"; when: mouseArea.pressed
           PropertyChanges {
               rect {
                   color: "blue"
                   height: container.height
               }
           }
        }
    }
}

마우스를 누르면 Rectangle 이 크기가 조정된 상태로 변경됩니다. 이 상태에서 PropertyChanges 객체는 사각형의 색을 파란색으로 설정하고 height 값을 container.height 의 값으로 설정합니다.

이렇게 하면 크기가 조정된 상태에서 rect.height 이 container.height 에 자동으로 바인딩됩니다. 속성 바인딩을 설정하지 않고 상태 변경 시 높이만 container.height 값으로 설정해야 하는 경우 explicit 속성을 true 로 설정합니다.

PropertyChanges 객체는 객체의 기본 시그널 핸들러를 재정의하여 새 상태와 관련된 시그널 핸들러를 구현할 수도 있습니다:

PropertyChanges {
    myMouseArea.onClicked: doSomethingDifferent()
}

속성 값 재설정하기

undefined 값은 상태의 속성 값을 재설정하는 데 사용할 수 있습니다. 다음 예제에서 myText 가 widerText 상태로 변경되면 width 속성이 재설정되어 텍스트가 자연스러운 너비를 가지며 전체 문자열이 한 줄에 표시됩니다.

Rectangle {
    width: 300; height: 200

    Text {
        id: myText
        width: 50
        wrapMode: Text.WordWrap
        text: "a text string that is longer than 50 pixels"

        states: State {
            name: "widerText"
            PropertyChanges { myText.width: undefined }
        }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: myText.state = "widerText"
    }
}

트랜지션의 즉각적인 속성 변경

트랜지션을 사용하여 상태 변경에 애니메이션을 적용하면 프로퍼티가 현재 상태의 값에서 새 상태의 정의된 값(PropertyChanges 객체에 정의된 대로)으로 애니메이션됩니다. 그러나 애니메이션 없이 Transition 중에 속성 값을 즉시 설정하는 것이 바람직한 경우도 있으며, 이러한 경우 PropertyAction 유형을 사용하여 즉시 속성 변경을 강제할 수 있습니다.

자세한 내용은 PropertyAction 문서를 참조하세요.

상태 예제, Qt Quick 상태 및 Qt Qml.

속성 문서

PropertyChanges {
    target: myItem
    explicit: true
    width: parent.width
}