Sur cette page

QAbstract3DInputHandler Class

Classe de base pour les implémentations des gestionnaires d'entrée. Plus d'informations...

En-tête : #include <QAbstract3DInputHandler>
CMake : find_package(Qt6 REQUIRED COMPONENTS DataVisualization)
target_link_libraries(mytarget PRIVATE Qt6::DataVisualization)
qmake : QT += datavisualization
Depuis : QtDataVisualization 1.0
En QML : AbstractInputHandler3D
Hérite : QObject
Hérité par :

Q3DInputHandler

Types publics

enum InputView { InputViewNone, InputViewOnPrimary, InputViewOnSecondary }

Propriétés

Fonctions publiques

virtual ~QAbstract3DInputHandler()
QPoint inputPosition() const
QAbstract3DInputHandler::InputView inputView() const
virtual void mouseDoubleClickEvent(QMouseEvent *event)
virtual void mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
virtual void mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
virtual void mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Q3DScene *scene() const
void setInputPosition(const QPoint &position)
void setInputView(QAbstract3DInputHandler::InputView inputView)
void setScene(Q3DScene *scene)
virtual void touchEvent(QTouchEvent *event)
virtual void wheelEvent(QWheelEvent *event)

Signaux

void inputViewChanged(QAbstract3DInputHandler::InputView view)
void positionChanged(const QPoint &position)
void sceneChanged(Q3DScene *scene)

Fonctions protégées

QAbstract3DInputHandler(QObject *parent = nullptr)
int prevDistance() const
QPoint previousInputPos() const
void setPrevDistance(int distance)
void setPreviousInputPos(const QPoint &position)

Description détaillée

QAbstract3DInputHandler est la classe de base qui est sous-classée par différentes implémentations de gestion d'entrée qui prennent les événements d'entrée et les traduisent en mouvements de caméra et de lumière. Les gestionnaires d'entrée traduisent également les événements d'entrée bruts en événements de découpage et de sélection dans la scène.

Documentation des types de membres

enum QAbstract3DInputHandler::InputView

Vues d'entrée prédéfinies pour les gestionnaires d'entrée basés sur la souris et le toucher.

ConstanteValeurDescription
QAbstract3DInputHandler::InputViewNone0La souris ou le toucher n'est pas sur une vue.
QAbstract3DInputHandler::InputViewOnPrimary1Entrée de la souris ou du toucher reçue dans la zone d'affichage principale. Si la vue secondaire est affichée lorsque inputView devient InputViewOnPrimary, la vue secondaire est fermée.
QAbstract3DInputHandler::InputViewOnSecondary2La souris ou le toucher a été reçu dans la zone d'affichage secondaire.

Documentation sur les propriétés

inputPosition : QPoint

Cette propriété contient la dernière position d'entrée basée sur les événements d'entrée traités.

Fonctions d'accès :

QPoint inputPosition() const
void setInputPosition(const QPoint &position)

Signal de notification :

void positionChanged(const QPoint &position)

inputView : InputView

Cette propriété contient la vue d'entrée énumérée actuelle basée sur la vue des événements d'entrée traités.

Une des valeurs de l'énumération InputView.

Lorsque la vue change, le signal inputViewChanged est émis.

Fonctions d'accès :

QAbstract3DInputHandler::InputView inputView() const
void setInputView(QAbstract3DInputHandler::InputView inputView)

Signal Notifier :

void inputViewChanged(QAbstract3DInputHandler::InputView view)

Voir également InputView.

scene : Q3DScene*

Cette propriété contient la scène 3D que ce gestionnaire d'entrée abstrait contrôle.

Un seul gestionnaire d'entrée peut contrôler une seule scène. L'attribution d'une scène à un gestionnaire d'entrée ne transfère pas la propriété de la scène.

Fonctions d'accès :

Q3DScene *scene() const
void setScene(Q3DScene *scene)

Signal Notificateur :

void sceneChanged(Q3DScene *scene)

Fonction membre Documentation

[explicit protected] QAbstract3DInputHandler::QAbstract3DInputHandler(QObject *parent = nullptr)

Construit la classe de base. Un paramètre optionnel parent peut être fourni et est alors transmis au constructeur QObject.

[virtual noexcept] QAbstract3DInputHandler::~QAbstract3DInputHandler()

Détruit la classe de base.

[virtual] void QAbstract3DInputHandler::mouseDoubleClickEvent(QMouseEvent *event)

Surchargez ceci pour gérer les événements de double clic de la souris. L'événement de double clic de la souris est donné dans le site event.

[virtual] void QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)

Surchargez ceci pour gérer les événements de déplacement de la souris. L'événement de déplacement de la souris est indiqué dans event et la position de la souris dans mousePos.

[virtual] void QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)

Surchargez ceci pour gérer les événements de pression de la souris. L'événement de pression de la souris est donné dans event et la position de la souris dans mousePos.

[virtual] void QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)

Surchargez ceci pour gérer les événements de relâchement de la souris. L'événement de relâchement de la souris est indiqué dans event et la position de la souris dans mousePos.

[protected] int QAbstract3DInputHandler::prevDistance() const

Renvoie la longueur de Manhattan entre les deux dernières positions d'entrée.

Voir aussi setPrevDistance().

[protected] QPoint QAbstract3DInputHandler::previousInputPos() const

Renvoie la position d'entrée précédente.

Voir aussi setPreviousInputPos().

[protected] void QAbstract3DInputHandler::setPrevDistance(int distance)

Définit le distance (longueur de Manhattan) entre les deux dernières positions d'entrée.

Voir aussi prevDistance().

[protected] void QAbstract3DInputHandler::setPreviousInputPos(const QPoint &position)

Fixe la position d'entrée précédente au point indiqué par position.

Voir aussi previousInputPos().

[virtual] void QAbstract3DInputHandler::touchEvent(QTouchEvent *event)

Surchargez ceci pour gérer les événements d'entrée tactile. L'événement tactile est donné dans le site event.

[virtual] void QAbstract3DInputHandler::wheelEvent(QWheelEvent *event)

Surchargez ceci pour gérer les événements de roue. L'événement roue est donné dans le site event.

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