ObjectPicker QML Type
Die Klasse „ObjectPicker“ instanziiert eine Komponente, mit der über einen als „Picking“ bezeichneten Vorgang mit einer Entität interagiert werden kann. Mehr...
| Import Statement: | import Qt3D.Render 2.12 |
| In C++: | QObjectPicker |
| Status: | Deprecated |
Dieser Typ ist veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- containsMouse : bool
- dragEnabled : bool
- hoverEnabled : bool
- pressed : bool
- priority : int
Signale
- clicked(PickEvent pick)
- entered()
- exited()
- moved(PickEvent pick)
- pressed(PickEvent pick)
- released(PickEvent pick)
Ausführliche Beschreibung
Für jede Kombination aus Ansichtsfenster und Kamera wird beim Picking ein Strahl durch die Szene geworfen, um Objekte zu finden, deren Begrenzungsvolumen den Strahl schneidet. Das Begrenzungsvolumen wird anhand der Werte im Attributpuffer berechnet, der durch das Attribut „boundingVolumePositionAttribute“ der Geometrie angegeben wird.
Die Signale „ pressed()“, „ released()“, „ clicked()“, „ moved()“, „ entered()“ und „ exited()“ werden ausgegeben, wenn sich das durch die Eigenschaft „pickAttribute“ definierte Begrenzungsvolumen mit einem Strahl schneidet.
Die meisten Signale enthalten eine Instanz von ` PickEvent `. Ist ` PickingSettings.pickMode` auf ` PickingSettings.TrianglePicking` gesetzt, ist der tatsächliche Typ des „pick“-Parameters ` PickTriangleEvent`.
Pick-Abfragen werden beim Drücken und Loslassen der Maustaste durchgeführt. Ist das Ziehen aktiviert, finden Abfragen zudem bei jeder Mausbewegung statt, solange eine Taste gedrückt ist. Ist das Hover-Verhalten aktiviert, finden Abfragen bei jeder Mausbewegung statt, auch wenn keine Taste gedrückt ist.
Hinweis: Um Hover-Ereignisse in „ QtQuick “zu empfangen, muss auch die Eigenschaft „ hoverEnabled “ von „ Scene3D “ gesetzt sein.
Hinweis: Instanzen dieser Komponente sollten nicht gemeinsam genutzt werden; die Nichtbeachtung dieser Bedingung führt höchstwahrscheinlich zu undefiniertem Verhalten.
Hinweis: Der Wertder Kamera-Farbeneebene beeinflusst die Auswahl und führt aufgrund der Gleitkommagenauigkeit zu falschen Ergebnissen, wenn er größer als ~100 000 ist.
Siehe auch „ PickingSettings“ , „ Geometry “, „ Attribute “, „ PickEvent “, „ PickTriangleEvent “ und „ NoPicking “.
Dokumentation zu Eigenschaften
containsMouse : bool [read-only]
Gibt an, ob der Objekt-Picker derzeit die Maus enthält
dragEnabled : bool
hoverEnabled : bool
Gibt an, ob die Hover-Funktion aktiviert ist
pressed : bool [read-only]
Gibt an, ob die Objekt-Auswahltaste derzeit gedrückt ist
priority : int
Die Priorität, die beim Filtern der Kommissionierergebnisse nach Priorität verwendet werden soll, wenn „PickingSettings.pickResultMode“ auf „PickingSettings.PriorityPick“ gesetzt ist.
Signal-Dokumentation
clicked(PickEvent pick)
Dieses Signal wird ausgelöst, wenn sich das durch die Eigenschaft „pickAttribute“ definierte Begrenzungsvolumen bei einem Mausklick mit einem Strahl schneidet. Informationen zum Schnittpunkt sind über den Parameter „ pick “ abrufbar.
Hinweis: Der entsprechende Handler lautet „ onClicked “.
entered()
Dieses Signal wird ausgelöst, wenn sich das durch die Eigenschaft „pickAttribute“ definierte Begrenzungsvolumen mit einem Strahl der Maus schneidet, der in das Volumen eindringt.
Hinweis: Der entsprechende Handler lautet „ onEntered “.
exited()
Dieses Signal wird ausgelöst, wenn das durch die Eigenschaft „pickAttribute“ definierte Begrenzungsvolumen einen Strahl schneidet, der aus dem Volumen austritt.
Hinweis: Der entsprechende Handler lautet „ onExited “.
moved(PickEvent pick)
Dieses Signal wird ausgelöst, wenn sich das durch die Eigenschaft „pickAttribute“ definierte Begrenzungsvolumen bei einer Mausbewegung mit gedrückter Maustaste mit einem Strahl schneidet. Die Schnittinformationen sind über den Parameter „ pick “ abrufbar.
Hinweis: Der entsprechende Handler ist „ onMoved “.
pressed(PickEvent pick)
Dieses Signal wird ausgelöst, wenn das durch die Eigenschaft „pickAttribute“ definierte Begrenzungsvolumen bei einem Mausklick einen Strahl schneidet. Informationen zur Schnittstelle sind über den Parameter „ pick “ abrufbar.
Hinweis: Der entsprechende Handler lautet „ onPressed “.
released(PickEvent pick)
Dieses Signal wird ausgelöst, wenn sich das durch die Eigenschaft „pickAttribute“ definierte Begrenzungsvolumen beim Loslassen der Maustaste mit einem Strahl schneidet. Informationen zum Schnittpunkt sind über den Parameter „ pick “ abrufbar.
Hinweis: Der entsprechende Handler lautet „ 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.
