Sur cette page

XrItem QML Type

Une surface virtuelle dans l'espace 3D qui peut contenir le contenu de l'interface utilisateur 2D. Plus d'informations...

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

Node

Propriétés

Description détaillée

Le type XrItem est un Qt Quick 3D Node qui représente un rectangle avec width et height. Il contient un Qt Quick Item , spécifié par contentItem, et le met à l'échelle. Il s'agit d'un moyen pratique de prendre des interfaces utilisateur traditionnelles en 2D et de les afficher sur une surface virtuelle ayant une taille réelle.

Tous les autres enfants du XrItem seront traités comme des enfants normaux d'un nœud et ne seront pas mis à l'échelle.

Par exemple, le code suivant créera une surface virtuelle de 1 mètre sur 1 mètre avec un élément de contenu de 600 pixels sur 600 pixels. Notez que l'effet ici est obtenu par la mise à l'échelle de l'élément de contenu et non par le rendu de l'élément de contenu à une résolution plus élevée.

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

Documentation sur les propriétés

automaticHeight : bool [default: "false"]

Lorsque cette valeur est fixée à true, XrItem ignore la hauteur définie par la propriété height et utilise la hauteur calculée à partir de la hauteur de contentItem.

Voir aussi automaticWidth.

automaticWidth : bool [default: "false"]

Lorsque cette valeur est fixée à true, XrItem ignore la largeur définie par la propriété width et utilise la largeur calculée à partir de contentItem width.

Voir également automaticHeight.

color : color [default: "white"]

Cette propriété définit la couleur d'arrière-plan du site XrItem.

contentItem : Item

Cette propriété contient l'élément de contenu qui sera affiché sur la surface virtuelle. La taille de l'élément de contenu sera utilisée pour calculer la valeur en pixels par unité et l'échelle sera basée sur la taille de cet élément.

Voir également pixelsPerUnit.

height : real

Cette propriété définit la hauteur du site XrItem dans le système de coordonnées 3D.

Voir aussi width.

manualPixelsPerUnit : bool [default: false]

Si cette propriété est true, le rapport entre le système de coordonnées 2D de l'élément de contenu et le système de coordonnées 3D de ce site XrItem est défini par la valeur de pixelsPerUnit. Si cette propriété est false, le rapport est calculé en fonction de la taille de l'élément de contenu et de la taille du site XrItem.

Voir également pixelsPerUnit.

pixelsPerUnit : real

Cette propriété détermine le nombre de pixels du système de coordonnées 2D de l'élément de contenu qui s'inscrivent dans une unité du système de coordonnées 3D de XrItem. Par défaut, cette valeur est calculée en fonction de la taille de l'élément de contenu et de la taille du site XrItem.

Définissez manualPixelsPerUnit pour désactiver le comportement par défaut et définir manuellement la valeur des pixels par unité.

Voir également manualPixelsPerUnit.

width : real

Cette propriété définit la largeur du site XrItem dans le système de coordonnées 3D.

Voir également 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.