ParentAnimation QML Type

Animiert Änderungen der übergeordneten Werte. Mehr...

Import Statement: import QtQuick
Inherits:

Animation

Eigenschaften

Detaillierte Beschreibung

ParentAnimation wird verwendet, um eine übergeordnete Änderung für ein Item zu animieren.

Mit der folgenden ParentChange wird blueRect zum Beispiel zu einem untergeordneten Element von redRect, wenn es angeklickt wird. Die Einbeziehung der ParentAnimation, die eine NumberAnimation definiert, die während des Übergangs angewendet wird, stellt sicher, dass das Element reibungslos animiert wird, wenn es zu seinem neuen Elternteil wechselt:

import QtQuick

Item {
    width: 200; height: 100

    Rectangle {
        id: redRect
        width: 100; height: 100
        color: "red"
    }

    Rectangle {
        id: blueRect
        x: redRect.width
        width: 50; height: 50
        color: "blue"

        states: State {
            name: "reparented"
            ParentChange { target: blueRect; parent: redRect; x: 10; y: 10 }
        }

        transitions: Transition {
            ParentAnimation {
                NumberAnimation { properties: "x,y"; duration: 1000 }
            }
        }

        MouseArea { anchors.fill: parent; onClicked: blueRect.state = "reparented" }
    }
}

Eine ParentAnimation kann eine beliebige Anzahl von Animationen enthalten. Diese Animationen werden parallel ausgeführt; um sie sequentiell auszuführen, definieren Sie sie innerhalb einer SequentialAnimation.

In einigen Fällen, z. B. beim Reparenting zwischen Elementen mit aktiviertem Clipping, ist es sinnvoll, die Änderung des übergeordneten Elements über ein anderes Element zu animieren, bei dem das Clipping nicht aktiviert ist. Ein solches Element kann mit der Eigenschaft via festgelegt werden.

ParentAnimation wird in der Regel innerhalb eines Transition in Verbindung mit einem ParentChange verwendet. Wenn es auf diese Weise verwendet wird, animiert es alle ParentChange, die während der Zustandsänderung aufgetreten sind. Dies kann überschrieben werden, indem ein bestimmtes Zielelement mit der Eigenschaft target festgelegt wird.

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

Eigenschaft Dokumentation

newParent : Item

Das neue übergeordnete Element, zu dem animiert werden soll.

Wenn ParentAnimation innerhalb einer Transition definiert ist, wird dieser Wert standardmäßig auf den im Endstatus der Transition definierten Wert gesetzt.


target : Item

Das Element, das repariert werden soll.

Wenn in einem Übergang kein Ziel angegeben ist, werden alle ParentChange -Ereignisse durch ParentAnimation animiert.


via : Item

Das Element, über das repariert werden soll. Auf diese Weise können Sie eine nicht beschnittene Animation durchführen, wenn sowohl das alte als auch das neue übergeordnete Element beschnitten sind.

ParentAnimation {
    target: myItem
    via: topLevelItem
    // ...
}

Hinweis: Dies funktioniert nur, wenn das ParentAnimation in einem Transition in Verbindung mit einem ParentChange verwendet wird.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.