このページでは

XrItem QML Type

2Dユーザーインターフェースのコンテンツを保持できる3D空間の仮想サーフェス。詳細...

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

Node

プロパティ

詳細説明

XrItemタイプは、widthheight で長方形を表すQt Quick 3D Node です。contentItem で指定されたQt Quick Item を1つ保持し、それに合うように拡大縮小します。これにより、従来の2Dユーザー・インタフェースを、実世界の大きさを持つ仮想サーフェス上に表示する便利な方法が提供されます。

XrItemの他の子はNodeの子として扱われ、スケーリングされません。

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

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

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

automaticHeight : bool [default: "false"]

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

automaticWidthも参照してください

automaticWidth : bool [default: "false"]

true に設定すると、XrItem は 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 の場合、比率は、contentItems のサイズとXrItem のサイズに基づいて計算される。

pixelsPerUnitも参照のこと

pixelsPerUnit : real

このプロパティは、contentItems の 2D 座標系のピクセル数が、XrItem の 3D 座標系の 1 単位に収まるかを決定する。デフォルトでは、これはコンテンツアイテムのサイズと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.