Auf dieser Seite

Qt3DRender::QPickEvent Class

class Qt3DRender::QPickEvent

Die Klasse „QPickEvent“ enthält Informationen darüber, wann ein Objekt ausgewählt wird. Mehr dazu...

Header: #include <qpickevent.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake: QT += 3drender
In QML: PickEvent
Erbt von: QObject
Vererbt an:

Qt3DRender::QPickLineEvent, „ Qt3DRender::QPickPointEvent “ sowie Qt3DRender::QPickTriangleEvent

Status: Veraltet

Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Öffentliche Typen

enum Buttons { LeftButton, RightButton, MiddleButton, BackButton, NoButton }
enum Modifiers { NoModifier, ShiftModifier, ControlModifier, AltModifier, MetaModifier, KeypadModifier }

Eigenschaften

Öffentliche Funktionen

QPickEvent()
QPickEvent(const QPointF &position, const QVector3D &intersection, const QVector3D &localIntersection, float distance)
QPickEvent(const QPointF &position, const QVector3D &worldIntersection, const QVector3D &localIntersection, float distance, Qt3DRender::QPickEvent::Buttons button, int buttons, int modifiers)
Qt3DRender::QPickEvent::Buttons button() const
int buttons() const
float distance() const
Qt3DCore::QEntity *entity() const
bool isAccepted() const
QVector3D localIntersection() const
int modifiers() const
QPointF position() const
Qt3DRender::QViewport *viewport() const
QVector3D worldIntersection() const

Öffentliche Slots

void setAccepted(bool accepted)

Signale

void acceptedChanged(bool accepted)

Detaillierte Beschreibung

Dies wird bei den meisten Signalen der „ QObjectPicker “-Komponente als Parameter empfangen, wenn die Auswahl erfolgreich ist.

Siehe auch „ QPickingSettings “, „ QPickTriangleEvent “ und „ QObjectPicker “.

Dokumentation zum Mitgliedstyp

enum QPickEvent::Buttons

KonstanteWert
Qt3DRender::QPickEvent::LeftButtonQt::LeftButton
Qt3DRender::QPickEvent::RightButtonQt::RightButton
Qt3DRender::QPickEvent::MiddleButtonQt::MiddleButton
Qt3DRender::QPickEvent::BackButtonQt::BackButton
Qt3DRender::QPickEvent::NoButtonQt::NoButton

enum QPickEvent::Modifiers

KonstanteWert
Qt3DRender::QPickEvent::NoModifierQt::NoModifier
Qt3DRender::QPickEvent::ShiftModifierQt::ShiftModifier
Qt3DRender::QPickEvent::ControlModifierQt::ControlModifier
Qt3DRender::QPickEvent::AltModifierQt::AltModifier
Qt3DRender::QPickEvent::MetaModifierQt::MetaModifier
Qt3DRender::QPickEvent::KeypadModifierQt::KeypadModifier

Eigenschaftsdokumentation

accepted : bool

Gibt an, ob das Ereignis angenommen wurde

Zugriffsfunktionen:

bool isAccepted() const
void setAccepted(bool accepted)

Benachrichtigungssignal:

void acceptedChanged(bool accepted)

[read-only] button : const Qt3DRender::QPickEvent::Buttons

Gibt die Maustaste an, die das Ereignis ausgelöst hat

Zugriffsfunktionen:

Qt3DRender::QPickEvent::Buttons button() const

[read-only] buttons : const int

Gibt den Status der Maustasten für das Ereignis an

Zugriffsfunktionen:

int buttons() const

[read-only] distance : const float

Gibt die Entfernung des Treffers zur Kamera an

Zugriffsfunktionen:

float distance() const

[read-only] entity : Qt3DCore::QEntity* const

Die Entität, zu der die ausgewählte Geometrie gehört.

Wenn der Objekt-Picker nicht an einen Blattknoten im Szenenbaum angeheftet ist, ist dies hilfreich, um herauszufinden, welche untergeordnete Entität tatsächlich ausgewählt wurde.

Zugriffsfunktionen:

Qt3DCore::QEntity *entity() const

[read-only] localIntersection : const QVector3D

Gibt die Koordinaten des Treffers im lokalen Koordinatensystem des ausgewählten Objekts an

Zugriffsfunktionen:

QVector3D localIntersection() const

[read-only] modifiers : const int

Gibt den Status der Maustasten für das Ereignis an

Zugriffsfunktionen:

int modifiers() const

[read-only] position : const QPointF

Gibt die Mausposition relativ zum Darstellungsbereich (Fenster oder Schnellzugriffselement) an

Zugriffsfunktionen:

QPointF position() const

[read-only] viewport : Qt3DRender::QViewport* const

Der Viewport, in dem dieses Ereignis ausgelöst wurde. Ein Nullwert bedeutet, dass das Ereignis von einem Zweig des Frame-Graphs ohne QViewport ausgelöst wurde. Wenn ein Zweig des Frame-Graphs einen Viewport innerhalb eines Viewports enthält, enthält die Eigenschaft den Blatt-Viewport.

Zugriffsfunktionen:

Qt3DRender::QViewport *viewport() const

[read-only] worldIntersection : const QVector3D

Gibt die Koordinaten des Treffers im Weltkoordinatensystem an

Zugriffsfunktionen:

QVector3D worldIntersection() const

Dokumentation zu den Mitgliedsfunktionen

QPickEvent::QPickEvent()

Erstellt ein neues QPickEvent.

QPickEvent::QPickEvent(const QPointF &position, const QVector3D &intersection, const QVector3D &localIntersection, float distance)

Erstellt ein neues `QPickEvent` mit den angegebenen Parametern: ` position`, ` intersection`, ` localIntersection ` und distance

QPickEvent::QPickEvent(const QPointF &position, const QVector3D &worldIntersection, const QVector3D &localIntersection, float distance, Qt3DRender::QPickEvent::Buttons button, int buttons, int modifiers)

Erstellt ein neues QPickEvent mit den angegebenen Parametern: position, worldIntersection, localIntersection, distance, button, buttons und modifiers

Qt3DRender::QPickEvent::Buttons QPickEvent::button() const

QPickEvent::button Gibt die Maustaste zurück, die das Ereignis ausgelöst hat

Hinweis: Getter -Funktion für die Eigenschaft „button“.

int QPickEvent::buttons() const

QPickEvent::buttons Gibt ein Bitfeld zurück, mit dem überprüft werden kann, ob dem Pick-Ereignis möglicherweise Maustasten zugeordnet sind.

Hinweis: Getter -Funktion für die Eigenschaft „buttons“.

float QPickEvent::distance() const

QPickEvent::distance Gibt den Abstand von der Kamera zum Auswahlpunkt zurück

Hinweis: Getter -Funktion für die Eigenschaft „distance“.

bool QPickEvent::isAccepted() const

QPickEvent::isAccepted Gibt „true“ zurück, wenn das Ereignis akzeptiert wurde

Hinweis: Getter -Funktion für die Eigenschaft „ accepted “.

QVector3D QPickEvent::localIntersection() const

QPickEvent::localIntersection Gibt die Koordinaten des Treffpunkts im lokalen Koordinatensystem des ausgewählten Objekts zurück

Hinweis: Getter -Funktion für die Eigenschaft „localIntersection“.

int QPickEvent::modifiers() const

QPickEvent::modifiers Gibt ein Bitfeld zurück, mit dem überprüft werden kann, ob dem Auswahlereignis Tastaturmodifikatoren beigefügt sind.

Hinweis: Getter -Funktion für die Eigenschaft „modifiers“.

QPointF QPickEvent::position() const

QPickEvent::position Gibt die Koordinaten des Mauszeigers für die Auswahlabfrage zurück

Hinweis: Getter -Funktion für die Eigenschaft „position“.

[slot] void QPickEvent::setAccepted(bool accepted)

QPickEvent::setAccepted – Wird gesetzt, wenn das Ereignis akzeptiert wurde, um accepted

Hinweis: Setter -Funktion für die Eigenschaft „ accepted “.

Siehe auch ` isAccepted()` .

QVector3D QPickEvent::worldIntersection() const

QPickEvent::worldIntersection Gibt die Koordinaten des Treffers im Weltkoordinatensystem zurück

Hinweis: Getter -Funktion für die Eigenschaft „worldIntersection“.

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