Q3DInputHandler Class
Einfacher Mausrad-basierter Input-Handler. Mehr...
| Kopfzeile: | #include <Q3DInputHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization)target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.0 |
| In QML: | InputHandler3D |
| Vererbt: | QAbstract3DInputHandler |
| Vererbt von: |
Eigenschaften
(since QtDataVisualization 1.2)rotationEnabled : bool(since QtDataVisualization 1.2)selectionEnabled : bool(since QtDataVisualization 1.2)zoomAtTargetEnabled : bool(since QtDataVisualization 1.2)zoomEnabled : bool
Öffentliche Funktionen
| 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) |
Reimplementierte öffentliche Funktionen
| 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 |
Signale
| void | rotationEnabledChanged(bool enable) |
| void | selectionEnabledChanged(bool enable) |
| void | zoomAtTargetEnabledChanged(bool enable) |
| void | zoomEnabledChanged(bool enable) |
Detaillierte Beschreibung
Q3DInputHandler ist der grundlegende Input-Handler für Eingabegeräte vom Typ Radmaus.
Der Standard Input Handler hat die folgenden Funktionen:
| Maus-Aktion | Aktion |
|---|---|
| Ziehen mit gedrückter rechter Taste | Drehen des Graphen innerhalb der für Q3DCamera festgelegten Grenzen. |
| Linksklick | Element unter dem Cursor auswählen oder Auswahl aufheben, wenn keine vorhanden ist. Kann je nach selection mode die sekundäre Ansicht öffnen. |
| Mausrad | Vergrößern/Verkleinern innerhalb des für Q3DCamera eingestellten zulässigen Zoombereichs. |
| Linksklick auf die primäre Ansicht, wenn die sekundäre Ansicht sichtbar ist | Schließt die sekundäre Ansicht. Hinweis: Die sekundäre Ansicht ist nur für die Diagramme Q3DBars und Q3DSurface verfügbar. |
Drehung, Zoom und Auswahl können jeweils einzeln über entsprechende Eigenschaften dieser Klasse deaktiviert werden.
Eigenschaft Dokumentation
[since QtDataVisualization 1.2] rotationEnabled : bool
Diese Eigenschaft gibt an, ob dieser Input-Handler eine Drehung des Graphen zulässt.
Die Voreinstellung ist true.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Zugriffsfunktionen:
| bool | isRotationEnabled() const |
| void | setRotationEnabled(bool enable) |
Notifier-Signal:
| void | rotationEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] selectionEnabled : bool
Diese Eigenschaft gibt an, ob dieser Input-Handler eine Auswahl aus dem Diagramm erlaubt.
Die Voreinstellung ist true.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Zugriffsfunktionen:
| bool | isSelectionEnabled() const |
| void | setSelectionEnabled(bool enable) |
Notifier-Signal:
| void | selectionEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] zoomAtTargetEnabled : bool
Diese Eigenschaft legt fest, ob beim Zoomen das Kameraziel so geändert werden soll, dass der gezoomte Punkt des Diagramms nach dem Zoomen an der gleichen Stelle bleibt.
Die Voreinstellung ist true.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Zugriffsfunktionen:
| bool | isZoomAtTargetEnabled() const |
| void | setZoomAtTargetEnabled(bool enable) |
Notifier Signal:
| void | zoomAtTargetEnabledChanged(bool enable) |
[since QtDataVisualization 1.2] zoomEnabled : bool
Diese Eigenschaft gibt an, ob dieser Input-Handler das Zoomen des Diagramms erlaubt.
Die Voreinstellung ist true.
Diese Eigenschaft wurde in QtDataVisualization 1.2 eingeführt.
Zugriffsfunktionen:
| bool | isZoomEnabled() const |
| void | setZoomEnabled(bool enable) |
Benachrichtigungssignal:
| void | zoomEnabledChanged(bool enable) |
Member Function Dokumentation
[explicit] Q3DInputHandler::Q3DInputHandler(QObject *parent = nullptr)
Konstruiert den grundlegenden Maus-Eingabe-Handler. Ein optionaler parent Parameter kann angegeben werden und wird dann an den QObject Konstruktor übergeben.
[virtual noexcept] Q3DInputHandler::~Q3DInputHandler()
Zerstört den Input-Handler.
[override virtual] void Q3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
Reimplements: QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos).
Überschreiben Sie dies, um die Behandlung von Mausbewegungsereignissen zu ändern. Das Mausbewegungsereignis wird in event und die Mausposition in mousePos angegeben.
[override virtual] void Q3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
Reimplements: QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos).
Überschreiben Sie dies, um die Behandlung von Mausdruckereignissen zu ändern. Das Maustastenereignis wird in event angegeben und die Mausposition in mousePos.
[override virtual] void Q3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Reimplements: QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos).
Überschreiben Sie dies, um die Behandlung von Mausfreigabeereignissen zu ändern. Das Mausfreigabeereignis wird in event und die Mausposition in mousePos angegeben.
[override virtual] void Q3DInputHandler::wheelEvent(QWheelEvent *event)
Reimplements: QAbstract3DInputHandler::wheelEvent(QWheelEvent *event).
Überschreiben Sie dies, um die Behandlung von Rad-Ereignissen zu ändern. Das Rad-Ereignis ist in event angegeben.
© 2025 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.
