En esta página

Conceptos: padre visual en Qt Quick

«Padre visual»

Al crear escenas visuales con Qt Quick, es importante comprender el concepto de «padre visual».

El concepto de «padre visual» en Qt Quick es independiente, aunque está relacionado, con el concepto de «padre de objeto » dentro de la jerarquía de padres de QObject. Todos los objetos QML tienen un padre de objeto, que viene determinado por la jerarquía de objetos en la que se declara el objeto. Al trabajar con el módulo QtQuick, el tipo Item es el tipo base para todos los elementos visuales que proporciona este módulo, y ofrece el concepto de un padre visual adicional, tal y como se define mediante la propiedad parent de un elemento. Cada elemento tiene un padre visual; si el valor de la propiedad parent de un elemento es null, el elemento no se mostrará en la escena.

Cualquier objeto asignado a la propiedad data de un elemento se convierte en un elemento secundario del mismo dentro de su jerarquía QObject, a efectos de gestión de la memoria. Además, si un objeto añadido a la propiedad «data» es de tipo Item, también se asigna a la propiedad « Item::children » y pasa a ser un elemento secundario del elemento dentro de la jerarquía visual de la escena. (La mayoría de los algoritmos de recorrido de la jerarquía Qt Quick, especialmente los algoritmos de representación, solo tienen en cuenta la jerarquía visual de elementos principales).

Por comodidad, la propiedad «Item» data es su propiedad por defecto. Esto significa que cualquier elemento secundario declarado dentro de un objeto « Item » sin estar asignado a una propiedad específica se asigna automáticamente a la propiedad « data » y pasa a ser un elemento secundario del elemento, tal y como se ha descrito anteriormente. Por lo tanto, los dos bloques de código siguientes producen el mismo resultado, y casi siempre verás el formulario que se muestra abajo a la izquierda, en lugar de la asignación explícita data que se muestra abajo a la derecha:

import QtQuick 2.0

Item {
    width: 100; height: 100

    Rectangle { width: 50;
                height: 50;
                color: "red" }
}
import QtQuick 2.0

Item {
    width: 100; height: 100

    data: [
        Rectangle { width: 50;
                    height: 50;
                    color: "red" }
    ]
}

El padre visual de un elemento se puede cambiar en cualquier momento estableciendo su propiedad parent. Por lo tanto, el padre visual de un elemento no tiene por qué ser necesariamente el mismo que su padre de objeto.

Cuando un elemento se convierte en hijo de otro elemento:

  • La propiedad ` parent ` del elemento hijo hace referencia a su elemento padre
  • Las propiedades « children » y « childrenRect » del padre tienen en cuenta a ese hijo

Declarar un elemento como hijo de otro no significa automáticamente que el elemento hijo vaya a colocarse o dimensionarse adecuadamente para encajar dentro de su padre. Algunos tipos de QML pueden tener comportamientos integrados que afectan a la posición de los elementos hijos —por ejemplo, un objeto ` Row ` reposiciona automáticamente a sus hijos en una formación horizontal—, pero se trata de comportamientos impuestos por las propias implementaciones específicas de dichos tipos. Además, un elemento padre no recortará automáticamente a sus hijos para contenerlos visualmente dentro de los límites visuales del padre, a menos que su propiedad ` clip ` esté establecida en `true`.

El padre visual de un elemento puede entrar en consideración en circunstancias concretas, tal y como se describe en las secciones siguientes.

Coordenadas de los elementos

Dado que las coordenadas de los elementos son relativas al padre visual, pueden verse afectadas por los cambios en la jerarquía visual. Consulta la página conceptual «Coordenadas visuales» para obtener más detalles.

Orden de superposición

Qt Quick Los elementos utilizan un algoritmo de dibujo recursivo para determinar qué elementos se dibujan encima en caso de colisiones. En general, los elementos se dibujan encima de sus elementos padres, en el orden en que se crearon (o se especificaron en el archivo QML). Así, en el siguiente ejemplo, el rectángulo azul se dibujará encima del rectángulo verde:

Rectangle {
    color: "#272822"
    width: 320
    height: 480

    Rectangle {
        y: 64
        width: 256
        height: 256
        color: "green"
    }

    Rectangle {
        x: 64
        y: 172
        width: 256
        height: 256
        color: "blue"
    }
}

Rectángulo verde sobre el que se superpone un rectángulo azul; el azul está dibujado encima

Dado que el algoritmo recorre de forma recursiva la jerarquía visual de elementos, cualquier elemento hijo del rectángulo verde también se dibujará debajo del rectángulo azul y debajo de cualquiera de los elementos hijos del rectángulo azul.

El orden de superposición puede modificarse mediante la propiedad ` Item::z `. Los valores `z` inferiores a 0 se superpondrán por debajo del elemento padre, y si se asignan valores `z`, los elementos hermanos se superpondrán según el orden `z` (utilizándose el orden de creación para desempatar). Los valores `z` solo afectan a la superposición en relación con los elementos hermanos y el elemento padre. Si tienes un elemento que queda oculto por un subárbol cuyo origen se encuentra por encima de su elemento padre, ningún valor z de ese elemento aumentará su orden de superposición para situarse por encima de dicho subárbol. Para que ese elemento se sitúe por encima del otro subárbol, tendrás que modificar los valores z en niveles superiores de la jerarquía o reorganizar la jerarquía visual de los elementos.

Rectangle {
    color: "#272822"
    width: 320
    height: 480

    Rectangle {
        y: 64
        z: 1
        width: 256
        height: 256
        color: "green"

        Rectangle {
            x: 192
            y: 64
            z: 2000
            width: 128
            height: 128
            color: "red"
        }
    }

    Rectangle {
        x: 64
        y: 192
        z: 2
        width: 256
        height: 256
        color: "blue"
    }
}

Rectángulos verdes, rojos y azules, con el rojo debajo del azul a pesar del alto valor de z

En el ejemplo anterior, el rectángulo rojo tiene un valor z alto, pero sigue apilado por debajo del rectángulo azul. Esto se debe a que es un elemento hijo del rectángulo verde, y el rectángulo verde es un elemento hermano del rectángulo azul. El valor z del rectángulo verde es inferior al del rectángulo azul, por lo que el rectángulo verde y todos sus hijos se colocarán por debajo del rectángulo azul.

Propiedad del lienzo

Lo que se representa en una escena de Qt Quick viene definido por el árbol de elementos visuales cuyo nodo raíz es QQuickWindow::contentItem. Por lo tanto, para añadir un elemento a una escena específica de Qt Quick con el fin de representarlo, este debe convertirse en un elemento secundario de la jerarquía visual de un elemento que ya se encuentre en dicha jerarquía, como QQuickWindow::contentItem.

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