Sur cette page

Qt3DRender::QPickEvent Class

class Qt3DRender::QPickEvent

La classe QPickEvent contient des informations relatives à la sélection d'un objet. En savoir plus...

En-tête : #include <qpickevent.h>
CMake : find_package(Qt6 REQUIRED COMPONENTS 3drender)
target_link_libraries(mytarget PRIVATE Qt6::3drender)
qmake : QT += 3drender
En QML : PickEvent
Hérite de : QObject
Hérité par :

Qt3DRender::QPickLineEvent, Qt3DRender::QPickPointEvent, et Qt3DRender::QPickTriangleEvent

Statut : Obsolète

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Types publics

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

Propriétés

Fonctions publiques

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

Emplacements publics

void setAccepted(bool accepted)

Signaux

void acceptedChanged(bool accepted)

Description détaillée

Ce paramètre est reçu dans la plupart des signaux du composant QObjectPicker lorsque la sélection aboutit.

Voir également QPickingSettings, QPickTriangleEvent et QObjectPicker.

Documentation sur les types de membres

enum QPickEvent::Buttons

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

enum QPickEvent::Modifiers

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

Documentation sur les propriétés

accepted : bool

Indique si l'événement a été accepté

Fonctions d'accès :

bool isAccepted() const
void setAccepted(bool accepted)

Signal de notification :

void acceptedChanged(bool accepted)

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

Indique le bouton de la souris à l'origine de l'événement

Fonctions d'accès :

Qt3DRender::QPickEvent::Buttons button() const

[read-only] buttons : const int

Spécifie l'état des boutons de la souris pour l'événement

Fonctions d'accès :

int buttons() const

[read-only] distance : const float

Indique la distance entre le point d'impact et la caméra

Fonctions d'accès :

float distance() const

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

L'entité à laquelle appartient la géométrie sélectionnée.

Si le sélecteur d'objets n'est pas attaché à un nœud feuille dans l'arbre de scène, cela permet de déterminer quelle entité enfant a effectivement été sélectionnée.

Fonctions d'accès :

Qt3DCore::QEntity *entity() const

[read-only] localIntersection : const QVector3D

Spécifie les coordonnées du point d'impact dans le système de coordonnées local de l'entité sélectionnée

Fonctions d'accès :

QVector3D localIntersection() const

[read-only] modifiers : const int

Spécifie l'état des boutons de la souris pour l'événement

Fonctions d'accès :

int modifiers() const

[read-only] position : const QPointF

Spécifie la position de la souris par rapport à la zone d'affichage (fenêtre ou élément rapide)

Fonctions d'accès :

QPointF position() const

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

La fenêtre d'affichage à l'origine de cet événement. Une valeur nulle signifie que l'événement provient d'une branche du graphe de cadres ne comportant pas de `QViewport`. Si une branche du graphe de cadres contient une fenêtre d'affichage à l'intérieur d'une autre fenêtre d'affichage, cette propriété indiquera la fenêtre d'affichage « feuille ».

Fonctions d'accès :

Qt3DRender::QViewport *viewport() const

[read-only] worldIntersection : const QVector3D

Spécifie les coordonnées du point d'impact dans le système de coordonnées mondial

Fonctions d'accès :

QVector3D worldIntersection() const

Documentation des fonctions membres

QPickEvent::QPickEvent()

Crée un nouvel objet QPickEvent.

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

Crée un nouvel objet `QPickEvent` avec les paramètres suivants : ` position`, ` intersection`, ` localIntersection ` et distance

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

Crée un nouvel objet `QPickEvent` avec les paramètres suivants : ` position`, ` worldIntersection`, ` localIntersection`, ` distance`, ` button`, ` buttons ` et modifiers

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

QPickEvent::button Renvoie le bouton de la souris à l'origine de l'événement

Remarque : fonctionde récupération pour la propriété button.

int QPickEvent::buttons() const

QPickEvent::buttons Renvoie un champ binaire permettant de vérifier quels boutons de souris sont éventuellement activés lors de l'événement de sélection.

Remarque : fonctionde récupération pour la propriété buttons.

float QPickEvent::distance() const

QPickEvent::distance Renvoie la distance entre la caméra et le point de sélection

Remarque : fonctiongetter pour la propriété distance.

bool QPickEvent::isAccepted() const

QPickEvent::isAccepted Renvoie « true » si l'événement a été accepté

Remarque : fonctionde lecture pour la propriété « accepted ».

QVector3D QPickEvent::localIntersection() const

QPickEvent::localIntersection Renvoie les coordonnées du point d'impact dans le système de coordonnées local de l'entité sélectionnée

Remarque : fonctionde lecture pour la propriété localIntersection.

int QPickEvent::modifiers() const

QPickEvent::modifiers Renvoie un champ de bits permettant de vérifier la présence de modificateurs clavier pouvant accompagner l'événement de sélection.

Remarque : fonctionde récupération pour la propriété modifiers.

QPointF QPickEvent::position() const

QPickEvent::position Renvoie les coordonnées du pointeur de souris correspondant à la requête de sélection

Remarque : fonctionde lecture de la propriété « position ».

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

QPickEvent::setAccepted : définit si l'événement a été accepté ou non accepted

Remarque : fonctionde définition de la propriété accepted.

Voir aussi isAccepted().

QVector3D QPickEvent::worldIntersection() const

QPickEvent::worldIntersection Renvoie les coordonnées du point d'impact dans le système de coordonnées mondial

Remarque : fonctionde lecture pour la propriété 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.