Q3DInputHandler Class
Gestionnaire d'entrée basique basé sur la roue de la souris. Plus d'informations...
| En-tête : | #include <Q3DInputHandler> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake : | QT += datavisualization |
| Depuis : | QtDataVisualization 1.0 |
| En QML : | InputHandler3D |
| Hérite : | QAbstract3DInputHandler |
| Hérité par : |
Propriétés
(since QtDataVisualization 1.2)rotationEnabled : bool(since QtDataVisualization 1.2)selectionEnabled : bool(since QtDataVisualization 1.2)zoomAtTargetEnabled : bool(since QtDataVisualization 1.2)zoomEnabled : bool
Fonctions publiques
| Q3DInputHandler(QObject *parent = nullptr) | |
| virtual | ~Q3DInputHandler() |
| bool | isRotationEnabled() const |
| bool | isSelectionEnabled() const |
| bool | isZoomAtTargetEnabled() const |
| bool | isZoomEnabled() const |
| void | setRotationEnabled(bool enable) |
| void | setSelectionEnabled(bool enable) |
| void | setZoomAtTargetEnabled(bool enable) |
| void | setZoomEnabled(bool enable) |
Fonctions publiques réimplémentées
| virtual void | mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos) override |
| virtual void | mousePressEvent(QMouseEvent *event, const QPoint &mousePos) override |
| virtual void | mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos) override |
| virtual void | wheelEvent(QWheelEvent *event) override |
Signaux
| void | rotationEnabledChanged(bool enable) |
| void | selectionEnabledChanged(bool enable) |
| void | zoomAtTargetEnabledChanged(bool enable) |
| void | zoomEnabledChanged(bool enable) |
Description détaillée
Q3DInputHandler est le gestionnaire d'entrée de base pour les périphériques d'entrée de type souris à molette.
Le gestionnaire d'entrée par défaut possède les fonctions suivantes :
| Action de la souris | Action de la souris |
|---|---|
| Glisser avec le bouton droit enfoncé | Rotation du graphique dans les limites définies pour Q3DCamera. |
| Clic gauche | Sélectionne l'élément sous le curseur ou supprime la sélection s'il n'y en a pas. Peut ouvrir la vue secondaire en fonction du site selection mode. |
| Roue de la souris | Zoom avant/arrière dans la plage de zoom autorisée pour Q3DCamera. |
| Clic gauche sur la vue principale lorsque la vue secondaire est visible | Ferme la vue secondaire. Remarque : la vue secondaire n'est disponible que pour les graphiques Q3DBars et Q3DSurface. |
La rotation, le zoom et la sélection peuvent être désactivés individuellement à l'aide des propriétés correspondantes de cette classe.
Propriété Documentation
[since QtDataVisualization 1.2] rotationEnabled : bool
Cette propriété indique si le gestionnaire d'entrée autorise la rotation du graphique.
La valeur par défaut est true.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Fonctions d'accès :
| bool | isRotationEnabled() const |
| void | setRotationEnabled(bool enable) |
Signal Notifier :
| void | rotationEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] selectionEnabled : bool
Cette propriété indique si ce gestionnaire d'entrée permet une sélection dans le graphique.
La valeur par défaut est true.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Fonctions d'accès :
| bool | isSelectionEnabled() const |
| void | setSelectionEnabled(bool enable) |
Signal Notifier :
| void | selectionEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] zoomAtTargetEnabled : bool
Cette propriété indique si le zoom doit modifier la cible de la caméra de sorte que le point zoomé du graphique reste au même endroit après le zoom.
La valeur par défaut est true.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Fonctions d'accès :
| bool | isZoomAtTargetEnabled() const |
| void | setZoomAtTargetEnabled(bool enable) |
Notifier signal :
| void | zoomAtTargetEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] zoomEnabled : bool
Cette propriété indique si ce gestionnaire d'entrée permet de zoomer sur le graphique.
La valeur par défaut est true.
Cette propriété a été introduite dans QtDataVisualization 1.2.
Fonctions d'accès :
| bool | isZoomEnabled() const |
| void | setZoomEnabled(bool enable) |
Signal Notificateur :
| void | zoomEnabledChanged(bool enable) |
Member Function Documentation
[explicit] Q3DInputHandler::Q3DInputHandler(QObject *parent = nullptr)
Construit le gestionnaire d'entrée de la souris de base. Un paramètre facultatif parent peut être fourni et est alors transmis au constructeur QObject.
[virtual noexcept] Q3DInputHandler::~Q3DInputHandler()
Détruit le gestionnaire d'entrée.
[override virtual] void Q3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
Réimplémente : QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos).
Surchargez cette fonction pour modifier la gestion des événements de déplacement de la souris. L'événement de déplacement de la souris est indiqué à l'adresse event et la position de la souris à l'adresse mousePos.
[override virtual] void Q3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
Réimplémente : QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos).
Surchargez cette fonction pour modifier la gestion des é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.
[override virtual] void Q3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Réimplémente : QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos).
Surchargez cette fonction pour modifier la gestion des événements de relâchement de la souris. L'événement de relâchement de la souris est indiqué à l'adresse event et la position de la souris à l'adresse mousePos.
[override virtual] void Q3DInputHandler::wheelEvent(QWheelEvent *event)
Réimplémente : QAbstract3DInputHandler::wheelEvent(QWheelEvent *event).
Surchargez cette fonction pour modifier la gestion des événements de roue. L'événement de la 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.
