Sur cette page

ParentAnimation QML Type

Anime les changements dans les valeurs des parents. Plus d'informations...

Import Statement: import QtQuick
Inherits:

Animation

Propriétés

Description détaillée

ParentAnimation est utilisé pour animer un changement de parent pour un Item.

Par exemple, le site ParentChange suivant transforme blueRect en enfant de redRect lorsqu'il est cliqué. L'inclusion d'une ParentAnimation, qui définit une NumberAnimation à appliquer pendant la transition, garantit que l'élément s'anime en douceur lorsqu'il passe à 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" }
    }
}

Une ParentAnimation peut contenir un nombre quelconque d'animations. Ces animations seront exécutées en parallèle ; pour les exécuter de manière séquentielle, définissez-les dans une SequentialAnimation.

Dans certains cas, par exemple lors de la répartition entre des éléments dont l'écrêtage est activé, il est utile d'animer le changement de parent par l'intermédiaire d'un autre élément dont l'écrêtage 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é dans un site Transition en conjonction avec un site ParentChange. Lorsqu'il est utilisé de cette manière, il anime tout site ParentChange qui s'est produit pendant le changement d'état. Il est possible d'outrepasser cette fonction en définissant un élément cible spécifique à l'aide de la propriété target.

Voir également Animation et Transitions dans Qt Quick et Qt Quick Exemples - Animation.

Documentation sur les propriétés

newParent : Item

Le nouveau parent à animer.

Si le site ParentAnimation est défini à l'intérieur d'un site Transition, cette valeur prend par défaut la valeur définie dans l'état final du site Transition.

target : Item

L'élément à reparenter.

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

via : Item

L'élément à reparenter via. Cela permet d'effectuer une animation sans clip lorsque l'ancien parent et le nouveau parent sont tous deux clipsés.

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

Remarque : cela ne fonctionne que lorsque le site ParentAnimation est utilisé dans un site Transition en conjonction avec un site ParentChange.

© 2026 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.