Q3DInputHandler Class
Gestionnaire de saisie de base pour souris à molette. En savoir plus...
| 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 de : | QAbstract3DInputHandler |
| Hérédité : | |
| Statut : | Obsolète |
Cette classe est obsolète. Nous déconseillons fortement de l'utiliser dans du nouveau code.
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 offre les fonctionnalités suivantes :
| Action de la souris | Action |
|---|---|
| Glisser en maintenant le bouton droit enfoncé | Fait pivoter le graphique dans les limites définies pour l'Q3DCamera. |
| Clic gauche | Sélectionne l'élément situé sous le curseur ou désélectionne s'il n'y en a pas. Peut ouvrir la vue secondaire en fonction de l'selection mode. |
| Molette de la souris | Effectuer un zoom avant/arrière dans la plage de zoom autorisée définie pour l'Q3DCamera. |
| Clic gauche sur la vue principale lorsque la vue secondaire est visible | Ferme la vue secondaire. Remarque : la vuesecondaire 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.
Documentation sur les propriétés
[since QtDataVisualization 1.2] rotationEnabled : bool
Cette propriété indique si ce gestionnaire d'entrée autorise la rotation du graphique.
La valeur par défaut est « true ».
Cette énumération a été introduite dans QtDataVisualization 1.2.
Fonctions d’accès :
| bool | isRotationEnabled() const |
| void | setRotationEnabled(bool enable) |
Signal de notification :
| void | rotationEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] selectionEnabled : bool
Cette propriété indique si ce gestionnaire d'entrée autorise la sélection à partir du graphique.
La valeur par défaut est « true ».
Cette énumération a été introduite dans QtDataVisualization 1.2.
Fonctions d'accès :
| bool | isSelectionEnabled() const |
| void | setSelectionEnabled(bool enable) |
Signal de notification :
| void | selectionEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] zoomAtTargetEnabled : bool
Cette propriété détermine si le zoom doit modifier la cible de la caméra afin que le point agrandi du graphique reste au même emplacement après le zoom.
La valeur par défaut est « true ».
Cette énumération a été introduite dans QtDataVisualization 1.2.
Fonctions d'accès :
| bool | isZoomAtTargetEnabled() const |
| void | setZoomAtTargetEnabled(bool enable) |
Signal de notification :
| void | zoomAtTargetEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] zoomEnabled : bool
Cette propriété indique si ce gestionnaire d'entrée autorise le zoom sur le graphique.
La valeur par défaut est « true ».
Cette énumération a été introduite dans QtDataVisualization 1.2.
Fonctions d'accès :
| bool | isZoomEnabled() const |
| void | setZoomEnabled(bool enable) |
Signal de notification :
| void | zoomEnabledChanged(bool enable) |
Documentation des fonctions membres
[explicit] Q3DInputHandler::Q3DInputHandler(QObject *parent = nullptr)
Crée le gestionnaire d'événements de souris de base. Un paramètre facultatif ` parent ` peut être fourni ; il est alors transmis au constructeur ` QObject `.
[virtual noexcept] Q3DInputHandler::~Q3DInputHandler()
Supprime le gestionnaire d'entrée.
[override virtual] void Q3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
Réimplémentation de : QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos).
Redéfinissez 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 fourni dans ` event ` et la position de la souris dans ` mousePos`.
[override virtual] void Q3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
Réimplémente : QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos).
Redéfinissez cette fonction pour modifier la gestion des événements de clic de souris. L’événement de clic de souris est fourni 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).
Redéfinissez 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 fourni dans event et la position de la souris dans mousePos.
[override virtual] void Q3DInputHandler::wheelEvent(QWheelEvent *event)
Réimplémente : QAbstract3DInputHandler::wheelEvent(QWheelEvent *event).
Redéfinissez cette méthode pour modifier la gestion des événements de molette. L'événement de molette est fourni dans l'objet 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.
