QAbstract3DInputHandler Class
Classe de base pour les implémentations des gestionnaires d'entrée. En savoir plus...
| 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 de : | QObject |
| Hérité par : | |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
Types publics
| enum | InputView { InputViewNone, InputViewOnPrimary, InputViewOnSecondary } |
Propriétés
- inputPosition : QPoint
- inputView : InputView
- scene : Q3DScene*
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 dont dérivent différentes implémentations de gestion des entrées qui réceptionnent les événements d’entrée et les traduisent en mouvements de caméra et d’éclairage. Les gestionnaires d’entrées traduisent également les événements d’entrée bruts en événements de découpage et de sélection dans la scène.
Documentation sur les types de membres
enum QAbstract3DInputHandler::InputView
Vues de saisie prédéfinies pour les gestionnaires de saisie par souris et par toucher.
| Constante | Valeur | Description |
|---|---|---|
QAbstract3DInputHandler::InputViewNone | 0 | Souris ou toucher hors d'une vue. |
QAbstract3DInputHandler::InputViewOnPrimary | 1 | Entrée souris ou tactile reçue sur la zone de vue principale. Si une vue secondaire est affichée lorsque l'inputView e passe à InputViewOnPrimary, la vue secondaire est fermée. |
QAbstract3DInputHandler::InputViewOnSecondary | 2 | Entrée souris ou tactile reçue sur la zone de la vue secondaire. |
Documentation de la propriété
inputPosition : QPoint
Cette propriété conserve la dernière position de saisie en fonction des événements de saisie 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, déterminée en fonction de la vue des événements d'entrée traités.
L'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 de notification :
| void | inputViewChanged(QAbstract3DInputHandler::InputView view) |
Voir également InputView.
scene : Q3DScene*
Cette propriété contient la scène 3D contrôlée par ce gestionnaire d'entrée abstrait.
Un gestionnaire d'entrée peut contrôler une seule scène. L'association d'une scène à un gestionnaire d'entrée n'entraîne pas le transfert de propriété de la scène.
Fonctions d'accès :
| Q3DScene * | scene() const |
| void | setScene(Q3DScene *scene) |
Signal de notification :
| void | sceneChanged(Q3DScene *scene) |
Documentation des fonctions membres
[explicit protected] QAbstract3DInputHandler::QAbstract3DInputHandler(QObject *parent = nullptr)
Construit la classe de base. Un paramètre facultatif de type « parent » peut être fourni ; il est alors transmis au constructeur de « QObject ».
[virtual noexcept] QAbstract3DInputHandler::~QAbstract3DInputHandler()
Supprime la classe de base.
[virtual] void QAbstract3DInputHandler::mouseDoubleClickEvent(QMouseEvent *event)
Redéfinissez cette méthode pour gérer les événements de double-clic de la souris. L'événement de double-clic de la souris est défini dans la classe ` event`.
[virtual] void QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
Redéfinissez cette méthode pour gérer les événements de déplacement de la souris. L'événement de déplacement de la souris est transmis via ` event ` et la position de la souris via ` mousePos`.
[virtual] void QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
Redéfinissez cette méthode pour gérer les événements de clic de souris. L'événement de clic de souris est transmis via ` event `, et la position de la souris via ` mousePos`.
[virtual] void QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Redéfinissez cette méthode pour gérer les événements de relâchement de la souris. L'événement de relâchement de la souris est transmis via ` event ` et la position de la souris via ` mousePos`.
[protected] int QAbstract3DInputHandler::prevDistance() const
Renvoie la longueur de Manhattan entre les deux dernières positions fournies.
Voir aussi setPrevDistance().
[protected] QPoint QAbstract3DInputHandler::previousInputPos() const
Renvoie la position précédente du curseur.
Voir aussi setPreviousInputPos().
[protected] void QAbstract3DInputHandler::setPrevDistance(int distance)
Calcule la longueur « distance » (longueur de Manhattan) entre les deux dernières positions saisies.
Voir également prevDistance().
[protected] void QAbstract3DInputHandler::setPreviousInputPos(const QPoint &position)
Définit la position de saisie précédente au point indiqué par position.
Voir également previousInputPos().
[virtual] void QAbstract3DInputHandler::touchEvent(QTouchEvent *event)
Redéfinissez cette méthode pour gérer les événements tactiles. L'événement tactile est transmis via la méthode ` event`.
[virtual] void QAbstract3DInputHandler::wheelEvent(QWheelEvent *event)
Redéfinissez cette méthode pour gérer les événements de molette. L'événement de molette est défini dans la classe ` 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.
