Q3DInputHandler Class
Einfacher Eingabe-Handler für Maus mit Scrollrad. Mehr...
| Header: | #include <Q3DInputHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Seit: | QtDataVisualization 1.0 |
| In QML: | InputHandler3D |
| Erbt von: | QAbstract3DInputHandler |
| Vererbt an: | |
| Status: | Veraltet |
Diese Klasse ist veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.
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) |
Neu implementierte ö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) |
Ausführliche Beschreibung
Q3DInputHandler ist der grundlegende Eingabehandler für Eingabegeräte vom Typ Maus mit Scrollrad.
Der Standard-Eingabehandler verfügt über folgende Funktionen:
| Mausaktion | Aktion |
|---|---|
| Ziehen bei gedrückter rechter Maustaste | Dreht das Diagramm innerhalb der für „ Q3DCamera “ festgelegten Grenzen. |
| Linksklick | Wählt das Element unter dem Cursor aus oder hebt die Auswahl auf, falls keine vorhanden ist. Je nach „ selection mode “ wird möglicherweise die sekundäre Ansicht geöffnet. |
| Mausrad | Vergrößern/Verkleinern innerhalb des für „ Q3DCamera “ festgelegten zulässigen Zoombereichs. |
| Linksklick auf die Hauptansicht, wenn die sekundäre Ansicht sichtbar ist | Schließt die sekundäre Ansicht. Hinweis: Diesekundäre Ansicht ist nur für Diagramme vom Typ „ Q3DBars “ und „ Q3DSurface “ verfügbar. |
Drehen, Zoomen und Auswählen können jeweils einzeln über die entsprechenden Eigenschaften dieser Klasse deaktiviert werden.
Dokumentation zu den Eigenschaften
[since QtDataVisualization 1.2] rotationEnabled : bool
Diese Eigenschaft gibt an, ob dieser Eingabe-Handler die Drehung von Diagrammen zulässt.
Standardwert ist „ true “.
Diese Aufzählung 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 Eingabe-Handler die Auswahl aus dem Diagramm zulässt.
Standardwert ist „ true “.
Diese Aufzählung 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 derselben Stelle verbleibt.
Standardwert ist „ true “.
Diese Aufzählung 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 Eingabe-Handler das Zoomen im Diagramm zulässt.
Der Standardwert ist „ true “.
Diese Aufzählung wurde in QtDataVisualization 1.2 eingeführt.
Zugriffsfunktionen:
| bool | isZoomEnabled() const |
| void | setZoomEnabled(bool enable) |
Notifier-Signal:
| void | zoomEnabledChanged(bool enable) |
Dokumentation der Mitgliedsfunktionen
[explicit] Q3DInputHandler::Q3DInputHandler(QObject *parent = nullptr)
Erstellt den grundlegenden Maus-Eingabehandler. Ein optionaler Parameter „ parent “ kann angegeben werden und wird dann an den Konstruktor „ QObject “ übergeben.
[virtual noexcept] Q3DInputHandler::~Q3DInputHandler()
Löscht den Eingabe-Handler.
[override virtual] void Q3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos)
Umsetzt: QAbstract3DInputHandler::mouseMoveEvent(QMouseEvent *event, const QPoint &mousePos).
Überschreiben Sie diese Funktion, um die Behandlung von Mausbewegungsereignissen zu ändern. Das Mausbewegungsereignis wird in ` event ` übergeben, die Mausposition in ` mousePos`.
[override virtual] void Q3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos)
Umsetzt: QAbstract3DInputHandler::mousePressEvent(QMouseEvent *event, const QPoint &mousePos).
Überschreiben Sie diese Funktion, um die Behandlung von Mausklick-Ereignissen zu ändern. Das Mausklick-Ereignis wird in ` event ` übergeben, die Mausposition in ` mousePos`.
[override virtual] void Q3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos)
Umsetzt: QAbstract3DInputHandler::mouseReleaseEvent(QMouseEvent *event, const QPoint &mousePos).
Überschreiben Sie diese Funktion, um die Verarbeitung von Mausloslass-Ereignissen zu ändern. Das Mausloslass-Ereignis wird in ` event ` übergeben, die Mausposition in ` mousePos`.
[override virtual] void Q3DInputHandler::wheelEvent(QWheelEvent *event)
Umsetzt: ` QAbstract3DInputHandler::wheelEvent` (`QWheelEvent *event`).
Überschreiben Sie diese Funktion, um die Behandlung von Scrollrad-Ereignissen zu ändern. Das Scrollrad-Ereignis wird in event übergeben.
© 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.
