PropertyChanges QML Type

Beschreibt neue Eigenschaftsbindungen oder Werte für einen Zustand. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Detaillierte Beschreibung

PropertyChanges wird verwendet, um die Eigenschaftswerte oder Bindungen in einem State zu definieren. Dadurch können die Eigenschaftswerte eines Elements geändert werden, wenn es zwischen Zuständen wechselt.

Um ein PropertyChanges-Objekt zu erstellen, binden Sie es an die Eigenschaften des Zielelements, so wie Sie es mit lokalen Eigenschaften tun würden. Auf diese Weise können Sie die neuen Eigenschaftswerte oder Bindungen definieren. Ein Beispiel:

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

Wenn die Maus gedrückt wird, wechselt die Rectangle in den Zustand " Größe geändert". In diesem Zustand setzt das PropertyChanges-Objekt die Farbe des Rechtecks auf Blau und den Wert von height auf den von container.height.

Beachten Sie, dass dadurch rect.height automatisch an container.height im Zustand " resized" gebunden wird. Wenn keine Eigenschaftsbindung hergestellt werden soll und die Höhe nur auf den Wert von container.height zum Zeitpunkt der Zustandsänderung gesetzt werden soll, setzen Sie die Eigenschaft explicit auf true.

Ein PropertyChanges-Objekt kann auch den Standardsignalhandler für ein Objekt überschreiben, um einen für den neuen Zustand spezifischen Signalhandler zu implementieren:

PropertyChanges {
    myMouseArea.onClicked: doSomethingDifferent()
}

Zurücksetzen von Eigenschaftswerten

Der Wert undefined kann verwendet werden, um den Eigenschaftswert für einen Zustand zurückzusetzen. Wenn im folgenden Beispiel myText in den Zustand widerText wechselt, wird die Eigenschaft width zurückgesetzt, wodurch der Text seine natürliche Breite erhält und die gesamte Zeichenfolge in einer einzigen Zeile angezeigt wird.

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

Unmittelbare Eigenschaftsänderungen in Übergängen

Wenn Übergänge verwendet werden, um Zustandsänderungen zu animieren, werden die Eigenschaften von ihren Werten im aktuellen Zustand zu den im neuen Zustand definierten Werten animiert (wie von PropertyChanges-Objekten definiert). Manchmal ist es jedoch wünschenswert, einen Eigenschaftswert sofort während einer Transition zu setzen, ohne Animation; in diesen Fällen kann der Typ PropertyAction verwendet werden, um eine sofortige Eigenschaftsänderung zu erzwingen.

Weitere Einzelheiten finden Sie in der Dokumentation PropertyAction.

Siehe auch Staaten Beispiel, Qt Quick Staaten, und Qt Qml.

Eigenschaft Dokumentation

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