Auf dieser Seite

XrItem QML Type

Eine virtuelle Fläche im 3D-Raum, auf der 2D-Inhalte der Benutzeroberfläche angezeigt werden können. Mehr...

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

Node

Status: Technology preview

Dieser Typ befindet sich in der Technologievorschau und kann sich noch ändern.

Eigenschaften

Ausführliche Beschreibung

Der Typ „XrItem“ ist ein „ Qt Quick 3D “ Node, der ein Rechteck mit den Koordinaten width und height darstellt. Er enthält ein „ Qt Quick “ Item, das durch contentItem spezifiziert ist, und skaliert dieses so, dass es passt. Dies bietet eine bequeme Möglichkeit, herkömmliche 2D-Benutzeroberflächen auf einer virtuellen Oberfläche mit realen Abmessungen darzustellen.

Alle anderen untergeordneten Elemente des `XrItem` werden wie normale untergeordnete Elemente eines `Node` behandelt und nicht skaliert.

Der folgende Code erstellt beispielsweise eine virtuelle Fläche von 1 Meter mal 1 Meter mit einem Inhaltselement von 600 Pixeln mal 600 Pixeln. Beachten Sie, dass der Effekt hier durch die Skalierung des Inhaltselements erzielt wird und nicht durch das Rendern des Inhaltselements in einer höheren Auflösung.

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

Dokumentation zu den Eigenschaften

automaticHeight : bool [default: "false"]

Wenn „ XrItem “ auf „true“ gesetzt ist, wird die über die Eigenschaft „height“ festgelegte Höhe ignoriert und stattdessen die anhand von „ contentItem “ berechnete Höhe verwendet.

Siehe auch „ automaticWidth “.

automaticWidth : bool [default: "false"]

Wenn der Wert auf „true“ gesetzt ist, ignoriert „ XrItem “ die über die Eigenschaft „width“ festgelegte Breite und verwendet stattdessen die aus „ contentItem “ berechnete Breite.

Siehe auch „ automaticHeight “.

color : color [default: "white"]

Diese Eigenschaft legt die Hintergrundfarbe des XrItem fest.

contentItem : Item

Diese Eigenschaft enthält das Inhaltselement, das auf der virtuellen Oberfläche angezeigt wird. Die Größe des Inhaltselements wird zur Berechnung des Werts „Pixel pro Einheit“ herangezogen, und die Skalierung erfolgt auf Basis der Größe dieses Elements.

Siehe auch „ pixelsPerUnit “.

height : real

Diese Eigenschaft legt die Höhe des „ XrItem “ im 3D-Koordinatensystem fest.

Siehe auch „ width “.

manualPixelsPerUnit : bool [default: false]

Wenn diese Eigenschaft auf „ true “ gesetzt ist, wird das Verhältnis zwischen dem 2D-Koordinatensystem des „contentItems“ und dem 3D-Koordinatensystem dieses „ XrItem “ durch den Wert von „ pixelsPerUnit “ definiert. Wenn diese Eigenschaft auf „ false “ gesetzt ist, wird das Verhältnis auf der Grundlage der Größe des „contentItems“ und der Größe des „ XrItem “ berechnet.

Siehe auch „ pixelsPerUnit “.

pixelsPerUnit : real

Diese Eigenschaft legt fest, wie viele Pixel im 2D-Koordinatensystem des „contentItems“ in eine Einheit des 3D-Koordinatensystems des „ XrItem “ passen. Standardmäßig wird dies anhand der Größe des „contentItems“ und der Größe des „ XrItem “ berechnet.

Setzen Sie „ manualPixelsPerUnit “, um das Standardverhalten zu deaktivieren und den Wert für „Pixel pro Einheit“ manuell festzulegen.

Siehe auch „ manualPixelsPerUnit “.

width : real

Diese Eigenschaft definiert die Breite des „ XrItem “ im 3D-Koordinatensystem.

Siehe auch „ 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.