ParentAnimation QML Type

Affiche les modifications apportées aux valeurs des éléments parents. En savoir plus…

• Liste de tous les membres, y compris les membres hérités

Propriétés

• newParent : Item
• target : Item
• via : Item

Description détaillée

ParentAnimation sert à animer le changement de parent d'un élément Item.

Par exemple, l'ParentChange suivante fait passer blueRect sous la tutelle de redRect lorsqu'on clique dessus. L'inclusion de ParentAnimation, qui définit un effet d'NumberAnimation à appliquer pendant la transition, garantit que l'élément s'anime en douceur lorsqu'il passe sous la tutelle de son nouveau parent :

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

Un ParentAnimation peut contenir un nombre illimité d’animations. Ces animations s’exécuteront en parallèle ; pour les exécuter séquentiellement, définissez-les au sein d’un SequentialAnimation.

Dans certains cas, par exemple lors d’un changement de parent entre des éléments pour lesquels le découpage est activé, il est utile d’animer le changement de parent via un autre élément pour lequel le découpage n’est pas activé. Un tel élément peut être défini à l’aide de la propriété ` via `.

ParentAnimation est généralement utilisé au sein d’un ` Transition ` en association avec un ` ParentChange`. Utilisé de cette manière, il anime tout changement de parent ( ParentChange ) survenu lors du changement d’état. Ce comportement peut être redéfini en spécifiant un élément cible à l’aide de la propriété ` target `.

Voir également «Animation et transitions » sur Qt Quick et « ExemplesQt Quick - Animation ».

Documentation sur les propriétés

newParent : Item

Le nouvel élément parent vers lequel effectuer l'animation.

Si l'ParentAnimation est défini dans une Transition, cette valeur prend par défaut la valeur définie dans l'état final de l'Transition.

target : Item

L'élément à réaffecter.

Lorsqu’il est utilisé dans une transition, si aucune cible n’est spécifiée, toutes les occurrences de l’ ParentChange sont animées par l’ ParentAnimation.

via : Item

L'élément à réaffecter à un parent. Cela permet de créer une animation non découpée lorsque l'ancien parent et le nouveau parent sont tous deux découpés.

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