PropertyAction QML Type

Gibt sofortige Eigenschaftsänderungen während der Animation an. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• exclude : list<QtObject>
• properties : string
• property : string
• target : QtObject
• targets : list<QtObject>
• value : var

Detaillierte Beschreibung

PropertyAction wird verwendet, um eine sofortige Eigenschaftsänderung während einer Animation anzugeben. Die Eigenschaftsänderung wird nicht animiert.

Sie ist nützlich, um nicht animierte Eigenschaftswerte während einer Animation festzulegen.

Hier ist zum Beispiel ein SequentialAnimation, das die Eigenschaft opacity des Bildes auf .5 setzt, die Breite des Bildes animiert und dann opacity wieder auf 1 setzt:

SequentialAnimation {
    PropertyAction { target: img; property: "opacity"; value: .5 }
    NumberAnimation { target: img; property: "width"; to: 300; duration: 1000 }
    PropertyAction { target: img; property: "opacity"; value: 1 }
}

PropertyAction ist auch nützlich, um den genauen Punkt festzulegen, an dem eine Eigenschaftsänderung während einer Transition stattfinden soll. Wenn PropertyChanges beispielsweise in einer State verwendet wird, um ein Element um einen bestimmten transformOrigin zu drehen, könnte es wie folgt implementiert werden:

Item {
    width: 400; height: 400

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

        states: State {
            name: "rotated"
            PropertyChanges { target: rect; rotation: 180; transformOrigin: Item.BottomRight }
        }

        transitions: Transition {
            RotationAnimation { duration: 1000; direction: RotationAnimation.Counterclockwise }
        }

        MouseArea {
            anchors.fill: parent
            onClicked: rect.state = "rotated"
        }
    }
}

Bei diesem Code wird die transformOrigin jedoch erst nach der Animation gesetzt, da eine State verwendet wird, um die Werte am Ende eines Übergangs zu definieren. Die Animation würde sich mit dem Standardwert transformOrigin drehen und dann zu Item.BottomRight springen. Um dies zu beheben, fügen Sie eine PropertyAction ein, bevor die RotationAnimation beginnt:

transitions: Transition {
    SequentialAnimation {
        PropertyAction { target: rect; property: "transformOrigin" }
        RotationAnimation { duration: 1000; direction: RotationAnimation.Counterclockwise }
    }
}

Dadurch wird die Eigenschaft transformOrigin sofort auf den Wert gesetzt, der im Endzustand des Transition definiert ist (d. h. den im PropertyAction-Objekt definierten Wert), so dass die Rotationsanimation mit dem richtigen Transformationsursprung beginnt.

Siehe auch Animation und Übergänge in Qt Quick und Qt Qml.

Property-Dokumentation