Sur cette page

pickResult QML Value Type

Contient les résultats d'une sélection. Plus...

Import Statement: import QtQuick3D

Propriétés

Description détaillée

Créé en tant qu'objet de retour à View3D::pick.

Documentation de la propriété

distance : real [read-only]

Cette propriété indique la distance entre l'origine de la prise et la position de l'impact, c'est-à-dire la longueur du rayon. Dans le cas de l'utilisation des coordonnées de la fenêtre pour la sélection, l'origine de la sélection sera la position de la caméra active.

hitType : enumeration [read-only, since 6.8]

Cette propriété indique le type de résultat de la sélection.

ConstanteDescription
PickResult.NullLa pioche n'a rien touché.
PickResult.ModelLa pioche a touché un modèle.
PickResult.ItemLa cueillette a touché un QQuickItem.

Cette propriété a été introduite dans Qt 6.8.

instanceIndex : int [read-only, since 6.5]

Cette propriété contient l'index dans la table d'instance pour le cas où la pioche a touché une instance d'un modèle instancié.

Cette propriété a été introduite dans Qt 6.5.

itemHit : Item [read-only, since 6.8]

Cette propriété contient l'élément Qt Quick touché par la pioche. Cette valeur sera nulle si hitType n'est pas pickResult.Item.

Cette propriété a été introduite dans Qt 6.8.

Voir aussi objectHit.

normal : vector3d [read-only]

Cette propriété contient la normale de la face qui a été touchée dans l'espace des coordonnées locales.

Remarque : pour les éléments 2D, cette propriété sera toujours (0, 0, 1).

objectHit : Model [read-only]

Cette propriété contient l'objet modèle touché par la pioche. Cette valeur sera nulle si hitType n'est pas pickResult.Model.

Voir également itemHit.

position : vector3d [read-only]

Cette propriété indique la position de la scène de l'impact dans l'espace de coordonnées locales.

sceneNormal : vector3d [read-only]

Cette propriété contient la normale du visage qui a été touché dans l'espace de coordonnées de la scène.

scenePosition : vector3d [read-only]

Cette propriété indique la position de l'impact sur la scène.

uvPosition : vector2d [read-only]

Cette propriété contient la position UV de l'impact. La position UV est calculée en tant que coordonnées x et y locales normalisées du point d'impact par rapport au volume délimité. Cette propriété est utile pour la sélection d'un objet hors écran.

Lorsque hitType est pickResult.Item, cette valeur représente la position du point d'impact dans l'espace de coordonnées de itemHit.

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