PropertyChanges QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

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

Ausführliche 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 verschiedenen Zuständen wechselt.

Um ein „PropertyChanges“-Objekt zu erstellen, binden Sie es an die Eigenschaften des Zielelements, so wie Sie es auch bei lokalen Eigenschaften tun würden. Auf diese Weise können Sie die neuen Eigenschaftswerte oder Bindungen definieren. 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 Maustaste gedrückt wird, wechselt das „ Rectangle “ in den Zustand „resized “. 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 “ im Zustand „resized“ automatisch an „ container.height “ gebunden wird. Sollte keine Eigenschaftsbindung hergestellt werden sollen und die Höhe zum Zeitpunkt des Zustandswechsels lediglich auf den Wert von „ container.height “ gesetzt werden, setzen Sie die Eigenschaft „ explicit “ auf „ true “.

Ein `PropertyChanges`-Objekt kann auch den Standard-Signal-Handler eines Objekts überschreiben, um einen für den neuen Zustand spezifischen Signal-Handler 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. Im folgenden Beispiel wird, wenn „ myText “ in den Zustand „widerText“ wechselt, 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"
    }
}

Sofortige Eigenschaftsänderungen bei Übergängen

Wenn Übergänge (Transitions) zur Animation von Zustandsänderungen verwendet werden, animieren sie Eigenschaften von ihren Werten im aktuellen Zustand zu den im neuen Zustand definierten Werten (wie durch „PropertyChanges“-Objekte festgelegt). Manchmal ist es jedoch wünschenswert, einen Eigenschaftswert während eines Übergangs ( Transition) sofort und ohne Animation festzulegen; in diesen Fällen kann der Typ „ PropertyAction “ verwendet werden, um eine sofortige Eigenschaftsänderung zu erzwingen.

Weitere Details finden Sie in der Dokumentation zu „ PropertyAction “.

Siehe auch das Beispiel „States“, Qt Quick States, sowie Qt Qml.

Dokumentation zu Eigenschaften

explicit : bool

Wenn „explicit“ auf „true“ gesetzt ist, werden Bindungen als Zuweisungen interpretiert. Der Ausdruck wird nur einmal ausgewertet, und es finden keine Aktualisierungen statt, selbst wenn sich die Abhängigkeiten ändern.

Im folgenden Beispiel verhindert das Hinzufügen von „explicit“, dass „ myItem.width “ an „ parent.width “ gebunden wird. Stattdessen wird ihm zum Zeitpunkt der Zustandsänderung der Wert von „ parent.width “ zugewiesen.

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

Standardmäßig ist „explicit“ auf „false“ gesetzt.

restoreEntryValues : bool

Diese Eigenschaft legt fest, ob beim Verlassen des Zustands die vorherigen Werte wiederhergestellt werden sollen.

Der Standardwert ist „ true “. Wenn dieser Wert auf „ false “ gesetzt wird, wird ein temporärer Zustand erstellt, der dauerhafte Auswirkungen auf die Eigenschaftswerte hat.

target : QtObject

Diese Eigenschaft enthält das Objekt, das die zu ändernden Eigenschaften enthält.