Sur cette page

XrItem QML Type

Surface virtuelle dans l'espace 3D pouvant accueillir du contenu d'interface utilisateur en 2D. En savoir plus...

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

Node

Status: Technology preview

Ce type est en phase de préversion technologique et est susceptible d'être modifié.

Propriétés

Description détaillée

Le type XrItem est un objet 3D de type « Qt Quick » ( Node ) qui représente un rectangle dont les dimensions sont définies par width et height. Il contient un élément Qt Quick Item , spécifié par contentItem, et le redimensionne pour l’adapter à la surface. Cela offre un moyen pratique de transposer des interfaces utilisateur 2D traditionnelles et de les afficher sur une surface virtuelle ayant une taille réelle.

Tous les autres éléments enfants de l’XrItem seront traités comme des éléments 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 contenant un élément de contenu de 600 pixels sur 600 pixels. Notez que l’effet obtenu ici résulte de la mise à l’échelle de l’élément de contenu et non d’un rendu de celui-ci à une résolution supérieure.

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

Documentation des propriétés

automaticHeight : bool [default: "false"]

Lorsqu'elle est définie sur « true », la propriété « XrItem » ignore la hauteur définie via la propriété « height » et utilise la hauteur calculée à partir de la hauteur de « contentItem ».

Voir également automaticWidth.

automaticWidth : bool [default: "false"]

Lorsqu'elle est définie sur « true », la propriété « XrItem » ignore la largeur définie via la propriété « width » et utilise la largeur calculée à partir de la largeur de « contentItem ».

Voir également automaticHeight.

color : color [default: "white"]

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

contentItem : Item

Cette propriété contient l'élément de contenu qui s'affichera sur la surface virtuelle. La taille de cet élément de contenu servira à calculer la valeur « pixels par unité » et à effectuer la mise à l'échelle en fonction de la taille de cet élément.

Voir également pixelsPerUnit.

height : real

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

Voir également « width ».

manualPixelsPerUnit : bool [default: false]

Si cette propriété prend la valeur « true », le rapport entre le système de coordonnées 2D des éléments de contenu et le système de coordonnées 3D de cette « XrItem » est défini par la valeur de « pixelsPerUnit ». Si cette propriété prend la valeur « false », le rapport est calculé en fonction de la taille de l'élément de contenu et de celle de la « 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 correspondent à une unité du système de coordonnées 3D de l'XrItem. Par défaut, cette valeur est calculée en fonction de la taille de l'élément de contenu et de celle de l'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 de l'XrItem e 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.