ObjectPicker QML Type
La classe ObjectPicker instancie un composant qui peut être utilisé pour interagir avec une entité par un processus connu sous le nom de picking. Plus d'informations...
| Import Statement: | import Qt3D.Render 2.11 |
| In C++: | QObjectPicker |
| Status: | Deprecated |
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 et de caméra, picking lance un rayon à travers la scène pour trouver les entités dont le volume de délimitation intersecte le rayon. Le volume de délimitation est calculé en utilisant les valeurs du tampon d'attribut 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 délimité défini par la propriété pickAttribute croise un rayon.
La plupart des signaux comportent une instance 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 lorsque la souris est pressée et relâchée. Si la fonction "glisser" est activée, les requêtes sont également effectuées à chaque déplacement de la souris lorsque l'un des boutons est enfoncé. Si le survol est activé, les requêtes sont effectuées à chaque mouvement 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 éloigné de la caméra affecte la sélection et produit des résultats incorrects en raison de la précision en virgule flottante si elle est supérieure à ~100 000.
Voir également PickingSettings, Geometry, Attribute, PickEvent, PickTriangleEvent, et NoPicking.
Documentation sur les propriétés
containsMouse : bool [read-only]
Spécifie si le sélecteur d'objets contient actuellement la souris
dragEnabled : bool
hoverEnabled : bool
Spécifie si le survol est activé
pressed : bool [read-only]
Spécifie si le sélecteur d'objets est actuellement activé
priority : int
La priorité à utiliser pour filtrer les résultats de la sélection par priorité lorsque PickingSettings.pickResultMode est défini sur PickingSettings.PriorityPick.
Documentation sur les signaux
clicked(PickEvent pick)
Ce signal est émis lorsque le volume délimité 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 délimité défini par la propriété pickAttribute croise un rayon de la souris entrant dans le volume.
Remarque : le gestionnaire correspondant est onEntered.
exited()
Ce signal est émis lorsque le volume délimité défini par la propriété pickAttribute croise un rayon sur le rayon sortant du volume.
Remarque : le gestionnaire correspondant est onExited.
moved(PickEvent pick)
Ce signal est émis lorsque le volume délimité 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 délimité défini par la propriété pickAttribute croise un rayon lors d'une pression de la souris. Les informations relatives à l'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élimité défini par la propriété pickAttribute croise un rayon lors du relâchement 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.
