En esta página

Conceptos: coordenadas visuales en Qt Quick

Coordenadas del elemento

El sistema predeterminado de coordenadas visuales utilizado en Qt Quick es el de coordenadas de elemento. Se trata de un sistema de coordenadas cartesianas con el punto (0,0) en la esquina superior izquierda del elemento. El eje x se extiende hacia la derecha y el eje y hacia abajo, de modo que la esquina inferior derecha del elemento se encuentra en las coordenadas (anchura, altura).

La posición de un elemento concreto se especifica en relación con el sistema de coordenadas de su padre. Esto significa que, al leer los valores x e y de elementos que no sean hermanos, puede ser necesario realizar una conversión para adaptarlos al mismo sistema de coordenadas. En estos casos, las coordenadas de escena suelen utilizarse como sistema de coordenadas intermedio.

Coordenadas de escena

Las coordenadas de la escena son aquellas en las que (0,0) corresponde a la esquina superior izquierda de la ventana en la que se está representando la escena en ese momento. Las coordenadas de la escena suelen ser las mismas que las coordenadas del elemento raíz de la ventana.

Puedes convertir las coordenadas de un elemento a coordenadas de escena utilizando las funciones del elemento cuyo sistema de coordenadas te interese. Consulta Item::mapFromItem y Item::mapToItem para convertir a coordenadas de escena o a las coordenadas de otro elemento.

Ejemplo práctico

El siguiente código QML crea una disposición de cuadrados, con puntos añadidos para identificar las posiciones:

Rectangle {
    width: 200
    height: 200
    color: "red"

    Rectangle {
        x: 100
        y: 100
        width: 100
        height: 100
        color: "blue"

        Rectangle {
            width: 50
            height: 50
            color: "green"
        }
    }
}

Rectángulo rojo con rectángulos azules y verdes anidados que muestran las posiciones de las coordenadas

En esta imagen, el punto negro está situado en (0,0) dentro de las coordenadas del elemento del rectángulo rojo. Si el rectángulo rojo fuera el elemento raíz de la escena, el punto negro también estaría situado en (0,0) en coordenadas de escena.

El rectángulo azul está situado en el punto blanco, (100,100), en relación con la esquina superior izquierda del rectángulo rojo.

El rectángulo verde no tiene especificadas las coordenadas x e y, por lo que su posición por defecto es (0,0). Como se encuentra en (0,0) según las coordenadas de su elemento padre, el rectángulo azul, queda situado en la esquina superior izquierda de dicho rectángulo. Este es el mismo punto que el punto blanco en (100,100) según las coordenadas del rectángulo rojo.

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