En esta página

XrItem QML Type

Una superficie virtual en el espacio 3D que puede contener contenido 2D de interfaz de usuario. Más...

Import Statement: import QtQuick3D.Xr
Since: Qt 6.8
Inherits:

Node

Propiedades

Descripción detallada

El tipo XrItem es un Qt Quick 3D Node que representa un rectángulo con width y height. Contiene un Qt Quick Item , especificado por contentItem, y lo escala para ajustarlo. Esto permite utilizar interfaces de usuario 2D tradicionales y mostrarlas en una superficie virtual con un tamaño real.

Cualquier otro hijo del XrItem será tratado como hijo normal de un Nodo, y no será escalado.

Por ejemplo, el siguiente código creará una superficie virtual de 1 metro por 1 metro con un elemento de contenido de 600 píxeles por 600 píxeles. Tenga en cuenta que el efecto aquí se consigue escalando el elemento de contenido y no renderizando el elemento de contenido a una resolución mayor.

XrItem {
    width: 100
    height: 100
    contentItem: Rectangle {
        width: 600
        height: 600
        color: "red"
    }
}

Documentación de propiedades

automaticHeight : bool [default: "false"]

Cuando se establece a true XrItem ignorará la altura establecida a través de la propiedad height y utilizará la altura calculada a partir de contentItem height.

Véase también automaticWidth.

automaticWidth : bool [default: "false"]

Cuando se establece a true XrItem ignorará la anchura establecida a través de la propiedad width y utilizará la anchura calculada a partir de contentItem width.

Véase también automaticHeight.

color : color [default: "white"]

Esta propiedad define el color de fondo de XrItem.

contentItem : Item

Esta propiedad contiene el elemento de contenido que se mostrará en la superficie virtual. El tamaño del elemento de contenido se utilizará para calcular el valor de píxeles por unidad y la escala basada en el tamaño de este elemento.

Véase también pixelsPerUnit.

height : real

Esta propiedad define la altura de XrItem en el sistema de coordenadas 3D.

Véase también width.

manualPixelsPerUnit : bool [default: false]

Si esta propiedad es true, la relación entre el sistema de coordenadas 2D de los elementos de contenido y el sistema de coordenadas 3D de este XrItem viene definida por el valor de pixelsPerUnit. Si esta propiedad es false, la relación se calcula en función del tamaño del elemento de contenido y del tamaño de XrItem.

Véase también pixelsPerUnit.

pixelsPerUnit : real

Esta propiedad determina cuántos píxeles del sistema de coordenadas 2D de los elementos de contenido caben en una unidad del sistema de coordenadas 3D de XrItem. Por defecto, se calcula en función del tamaño del elemento de contenido y del tamaño de XrItem.

Configure manualPixelsPerUnit para desactivar el comportamiento predeterminado y establecer manualmente el valor de píxeles por unidad.

Véase también manualPixelsPerUnit.

width : real

Esta propiedad define la anchura de XrItem en el sistema de coordenadas 3D.

Véase también height.

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