ParentAnimation QML Type
Muestra de forma animada los cambios en los valores de los elementos principales. Más...
| Import Statement: | import QtQuick |
| Inherits: |
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.