ObjectPicker QML Type
La classe `ObjectPicker` instancie un composant permettant d'interagir avec une entité via un processus appelé « sélection ». En savoir plus...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QObjectPicker |
| Status: | Deprecated |
Ce type est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Propriétés
- containsMouse : bool
- dragEnabled : bool
- hoverEnabled : bool
- pressed : bool
- priority : int
Signaux
- clicked(PickEvent pick)
- entered()
- exited()
- moved(PickEvent pick)
- pressed(PickEvent pick)
- released(PickEvent pick)
Description détaillée
Pour chaque combinaison de fenêtre d'affichage et de caméra, la sélection projette un rayon à travers la scène afin de trouver les entités dont le volume englobant coupe ce rayon. Le volume englobant est calculé à partir des valeurs contenues dans le tampon d'attributs spécifié par l'attribut `boundingVolumePositionAttribute` de la géométrie.
Les signaux pressed(), released(), clicked(), moved(), entered() et exited() sont émis lorsque le volume englobant défini par la propriété pickAttribute croise un rayon.
La plupart des signaux transportent une instance de ` PickEvent `. Si ` PickingSettings.pickMode` est défini sur ` PickingSettings.TrianglePicking`, le type réel du paramètre `pick` sera ` PickTriangleEvent`.
Les requêtes de sélection sont effectuées lors de l’activation et de la désactivation du bouton de la souris. Si le glissement est activé, des requêtes ont également lieu à chaque déplacement de la souris tant qu’un bouton est enfoncé. Si le survol est activé, des requêtes ont lieu à chaque déplacement de la souris, même si aucun bouton n’est enfoncé.
Remarque : pour recevoir des événements de survol dans QtQuick, la propriété hoverEnabled de Scene3D doit également être définie.
Remarque : les instances de ce composant ne doivent pas être partagées ; le non-respect de cette condition entraînera très probablement un comportement indéfini.
Remarque : la valeur du plan lointain de la caméra affecte la sélection et produit des résultats incorrects en raison de la précision des nombres à virgule flottante si elle est supérieure à environ 100 000.
Voir également PickingSettings, Geometry, Attribute, PickEvent, PickTriangleEvent et NoPicking.
Documentation relative aux propriétés
containsMouse : bool [read-only]
Indique si le sélecteur d'objets contient actuellement la souris
dragEnabled : bool
hoverEnabled : bool
Indique si la fonction « hover » est activée
pressed : bool [read-only]
Indique si le bouton de sélection d'objet est actuellement enfoncé
priority : int
Priorité à utiliser pour filtrer les résultats de préparation en fonction de la priorité lorsque PickingSettings.pickResultMode est défini sur PickingSettings.PriorityPick.
Documentation sur les signaux
clicked(PickEvent pick)
Ce signal est émis lorsque le volume englobant défini par la propriété `pickAttribute` croise un rayon lors d'un clic de souris. Les informations relatives à l'intersection sont accessibles via le paramètre ` pick `.
Remarque : le gestionnaire correspondant est ` onClicked`.
entered()
Ce signal est émis lorsque le volume englobant défini par la propriété `pickAttribute` croise un rayon émis par la souris qui pénètre dans ce volume.
Remarque : le gestionnaire correspondant est onEntered.
exited()
Ce signal est émis lorsque le volume englobant défini par la propriété `pickAttribute` coupe un rayon sortant de ce volume.
Remarque : le gestionnaire correspondant est onExited.
moved(PickEvent pick)
Ce signal est émis lorsque le volume englobant défini par la propriété `pickAttribute` croise un rayon lors d'un déplacement de la souris avec un bouton enfoncé. Les informations relatives à l'intersection sont accessibles via le paramètre ` pick `.
Remarque : le gestionnaire correspondant est onMoved.
pressed(PickEvent pick)
Ce signal est émis lorsque le volume englobant défini par la propriété `pickAttribute` croise un rayon au moment où l'utilisateur clique avec la souris. Les informations relatives à cette intersection sont accessibles via le paramètre ` pick `.
Remarque : le gestionnaire correspondant est onPressed.
released(PickEvent pick)
Ce signal est émis lorsque le volume d'encadrement défini par la propriété `pickAttribute` croise un rayon au moment où l'utilisateur relâche le bouton de la souris. Les informations relatives à l'intersection sont accessibles via le paramètre ` pick `.
Remarque : le gestionnaire correspondant est onReleased.
© 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.
