このページでは

XrItem QML Type

3D空間内にあり、2Dのユーザーインターフェースコンテンツを表示できる仮想面。詳細...

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

Node

Status: Technology preview

このタイプはテクノロジープレビュー段階にあり、変更される可能性があります。

プロパティ

詳細な説明

XrItem型は、Qt Quick の3DNode であり、width およびheight を持つ矩形を表します。これは、contentItem で指定された1つのQt Quick (Item )を保持し、画面に収まるように拡大縮小します。これにより、従来の2Dユーザーインターフェースを、実世界のサイズを持つ仮想表面上に表示するための便利な方法が提供されます。

XrItemのその他の子要素は、Nodeの通常の子要素として扱われ、スケーリングは行われません。

たとえば、次のコードは、1メートル×1メートルの仮想サーフェスと、600ピクセル×600ピクセルのコンテンツアイテムを作成します。ここで得られる効果は、コンテンツアイテムを高解像度でレンダリングすることではなく、コンテンツアイテムをスケーリングすることによって達成される点に注意してください。

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

プロパティのドキュメント

automaticHeight : bool [default: "false"]

XrItem を true に設定すると、height プロパティで設定された高さは無視され、contentItem の高さから計算された高さが使用されます。

automaticWidthも参照してください 。

automaticWidth : bool [default: "false"]

XrItem を true に設定すると、width プロパティで設定された幅は無視され、contentItem の幅から算出された幅が使用されます。

「automaticHeight」も参照してください 。

color : color [default: "white"]

このプロパティは、XrItem の背景色を指定します。

contentItem : Item

このプロパティには、仮想サーフェス上に表示されるコンテンツアイテムが格納されます。コンテンツアイテムのサイズに基づいて、単位あたりのピクセル数が計算され、このアイテムのサイズに応じて拡大・縮小が行われます。

「pixelsPerUnit」も参照してください 。

height : real

このプロパティは、3D座標系におけるXrItem の高さを定義します。

「width」も参照してください 。

manualPixelsPerUnit : bool [default: false]

このプロパティがtrue の場合、contentItemsの2D座標系とこのXrItem の3D座標系の比率は、pixelsPerUnit の値によって定義されます。このプロパティがfalse の場合、その比率はcontent itemのサイズとXrItem のサイズに基づいて計算されます。

「pixelsPerUnit」も参照してください 。

pixelsPerUnit : real

このプロパティは、XrItem の3D座標系における1単位に、contentItemsの2D座標系で何ピクセルが収まるかを決定します。デフォルトでは、これはコンテンツ項目のサイズとXrItem のサイズに基づいて計算されます。

manualPixelsPerUnit を設定してデフォルトの動作を無効にし、単位あたりのピクセル数を手動で設定します。

「manualPixelsPerUnit」も参照してください 。

width : real

このプロパティは、3D座標系におけるXrItem の幅を定義します。

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