En esta página

ParentAnimation QML Type

Muestra de forma animada los cambios en los valores de los elementos principales. Más...

Import Statement: import QtQuick
Inherits:

Animation

Propiedades

Descripción detallada

ParentAnimation se utiliza para animar un cambio en el elemento padre de un Item.

Por ejemplo, el siguiente ` ParentChange ` cambia ` blueRect ` para que pase a ser un elemento secundario de ` redRect ` al hacer clic en él. La inclusión de `ParentAnimation`, que define un ` NumberAnimation ` que se aplicará durante la transición, garantiza que el elemento se anime con fluidez a medida que se desplaza hacia su nuevo elemento principal:

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» puede contener cualquier número de animaciones. Estas animaciones se ejecutarán en paralelo; para ejecutarlas secuencialmente, defínelas dentro de un « SequentialAnimation ».

En algunos casos, como al cambiar de padre entre elementos con el recorte activado, resulta útil animar el cambio de padre a través de otro elemento que no tenga el recorte activado. Dicho elemento se puede establecer mediante la propiedad « via ».

ParentAnimation se suele utilizar dentro de un ` Transition ` junto con un ` ParentChange`. Cuando se utiliza de esta manera, anima cualquier ` ParentChange ` que haya tenido lugar durante el cambio de estado. Esto se puede anular estableciendo un elemento de destino específico mediante la propiedad ` target `.

Véase también «Animación y transiciones» en Qt Quick y «Ejemplos deQt Quick: Animación».

Documentación de la propiedad

newParent : Item

El nuevo elemento padre al que se aplicará la animación.

Si el « ParentAnimation » se define dentro de un « Transition », este valor toma por defecto el valor definido en el estado final del « Transition ».

target : Item

El elemento al que se va a reasignar.

Cuando se utiliza en una transición, si no se especifica ningún destino, todas las apariciones de « ParentChange » se animan mediante « ParentAnimation ».

via : Item

El elemento al que se va a reasignar la relación de padre. Esto permite crear una animación sin recorte cuando tanto el padre anterior como el nuevo están recortados.

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

Nota: Esto solo funciona cuando se utiliza el « ParentAnimation » en un « Transition » junto con un « 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.