En esta página

XrItem QML Type

Una superficie virtual en el espacio 3D que puede albergar contenido de interfaz de usuario en 2D. Más información...

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

Node

Status: Technology preview

Este tipo se encuentra en fase de vista previa tecnológica y está sujeto a cambios.

Propiedades

Descripción detallada

El tipo XrItem es un objeto 3D de tipo « Qt Quick » ( Node ) que representa un rectángulo con width y height. Contiene un objeto Qt Quick ( Item), especificado mediante contentItem, y lo escala para que se ajuste al espacio disponible. Esto ofrece una forma cómoda de tomar interfaces de usuario 2D tradicionales y mostrarlas en una superficie virtual que tiene un tamaño real.

Cualquier otro elemento secundario del XrItem se tratará como un elemento secundario normal de un nodo y no se escalará.

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. Ten en cuenta que el efecto se consigue aquí escalando el elemento de contenido y no representándolo 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 en «true», « XrItem » ignorará la altura definida mediante la propiedad «height» y utilizará la altura calculada a partir de « contentItem ».

Véase también automaticWidth.

automaticWidth : bool [default: "false"]

Cuando se establece en «true», « XrItem » ignorará el ancho definido mediante la propiedad «width» y utilizará el ancho calculado a partir del ancho de « contentItem ».

Véase también automaticHeight.

color : color [default: "white"]

Esta propiedad define el color de fondo del elemento ` 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 en función del tamaño de dicho elemento.

Véase también pixelsPerUnit.

height : real

Esta propiedad define la altura del « 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 «contentItems» 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 del « XrItem ».

Véase también pixelsPerUnit.

pixelsPerUnit : real

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

Establece ` manualPixelsPerUnit ` para desactivar el comportamiento predeterminado y configura manualmente el valor de píxeles por unidad.

Véase también manualPixelsPerUnit.

width : real

Esta propiedad define la anchura del « 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.