En esta página

ParentChange QML Type

Especifica cómo cambiar el padre de un elemento cuando se produce un cambio de estado. Más información...

Import Statement: import QtQuick

Propiedades

Descripción detallada

ParentChange cambia la relación de parentesco de un elemento conservando su aspecto visual (posición, tamaño, rotación y escala) en pantalla. A continuación, puedes especificar una transición para mover, cambiar el tamaño, rotar o escalar el elemento hasta que adquiera el aspecto final deseado.

ParentChange solo puede conservar la apariencia visual si no intervienen transformaciones complejas. Más concretamente, no funcionará si se ha establecido la propiedad «transform» para alguno de los elementos implicados en el cambio de padre (es decir, elementos del árbol de antepasados común al padre original y al nuevo).

El ejemplo siguiente muestra un rectángulo rojo grande y un rectángulo azul pequeño, uno al lado del otro. Al hacer clic en el « blueRect », este cambia al estado «reparented»: su padre pasa a ser redRect y se coloca en la posición (10, 10) dentro del rectángulo rojo, tal y como se especifica en el ParentChange.

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

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

El cambio de estado del cuadrado azul que afecta a la reasignación del elemento principal

Puedes especificar en qué momento de una transición deseas que se produzca un «ParentChange» utilizando un « ParentAnimation ».

Ten en cuenta que, a diferencia de PropertyChanges, ParentChange espera un destino basado en un Item; no funcionará con objetos arbitrarios (por ejemplo, no podrías utilizarlo para cambiar el padre de un Timer).

Documentación de propiedades

height : real

rotation : real

scale : real

width : real

x : real

y : real

Estas propiedades contienen la nueva posición, tamaño, escala y rotación del elemento en este estado.

parent : Item

Esta propiedad contiene el nuevo elemento principal del elemento en este estado.

target : Item

Esta propiedad contiene el elemento al que se le va a asignar un nuevo padre

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