Sur cette page

ParentChange QML Type

Indique comment répartir un élément lors d'un changement d'état. Plus d'informations...

Import Statement: import QtQuick

Propriétés

Description détaillée

ParentChange reporte un élément tout en préservant son apparence visuelle (position, taille, rotation et échelle) à l'écran. Vous pouvez ensuite spécifier une transition pour déplacer/redimensionner/rotation/échelle l'élément jusqu'à son apparence finale.

ParentChange ne peut préserver l'apparence visuelle que si aucune transformation complexe n'est impliquée. Plus précisément, il ne fonctionnera pas si la propriété transform a été définie pour tout élément impliqué dans la répartition (c'est-à-dire les éléments de l'arbre des ancêtres commun au parent d'origine et au nouveau parent).

L'exemple ci-dessous montre un grand rectangle rouge et un petit rectangle bleu, côte à côte. Lorsque l'on clique sur le site blueRect, il passe à l'état "reparenté" : son parent devient redRect et il est positionné à (10, 10) à l'intérieur du rectangle rouge, comme spécifié dans le 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" }
    }
}

Vous pouvez spécifier à quel moment d'une transition vous souhaitez qu'un ParentChange se produise en utilisant un ParentAnimation.

Notez que contrairement à PropertyChanges, ParentChange attend une cible basée sur un élément ; il ne fonctionnera pas avec des objets arbitraires (par exemple, vous ne pourriez pas l'utiliser pour répartir un Timer).

Documentation sur les propriétés

height : real

rotation : real

scale : real

width : real

x : real

y : real

Ces propriétés contiennent la nouvelle position, la taille, l'échelle et la rotation de l'élément dans cet état.

parent : Item

Cette propriété contient le nouveau parent de l'élément dans cet état.

target : Item

Cette propriété contient l'élément à répartir

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