Q3DInputHandler Class
Basic wheel mouse based input handler. More...
| Header: | #include <Q3DInputHandler> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake: | QT += datavisualization |
| Since: | QtDataVisualization 1.0 |
| Instantiated By: | InputHandler3D |
| Inherits: | QAbstract3DInputHandler |
| Inherited By: |
Properties
- rotationEnabled : bool
- selectionEnabled : bool
- zoomAtTargetEnabled : bool
- zoomEnabled : bool
Public Functions
| virtual | ~Q3DInputHandler() |
| bool | isRotationEnabled() const |
| bool | isSelectionEnabled() const |
| bool | isZoomAtTargetEnabled() const |
| bool | isZoomEnabled() const |
| void | setRotationEnabled() |
| void | setSelectionEnabled() |
| void | setZoomAtTargetEnabled() |
| void | setZoomEnabled() |
Signals
| void | rotationEnabledChanged() |
| void | selectionEnabledChanged() |
| void | zoomAtTargetEnabledChanged() |
| void | zoomEnabledChanged() |
Detailed Description
Q3DInputHandler is the basic input handler for wheel mouse type of input devices.
Default input handler has the following functionalty:
| Mouse action | Action |
|---|---|
| Drag with right button pressed | Rotate graph within limits set for Q3DCamera. |
| Left click | Select item under cursor or remove selection if none. May open the secondary view depending on the selection mode. |
| Mouse wheel | Zoom in/out within the allowable zoom range set for Q3DCamera. |
| Left click on the primary view when the secondary view is visible | Closes the secondary view. Note: Secondary view is available only for Q3DBars and Q3DSurface graphs. |
Rotation, zoom, and selection can each be individually disabled using corresponding properties of this class.
Property Documentation
[since QtDataVisualization 1.2] rotationEnabled : bool
This property holds whether this input handler allows graph rotation.
Defaults to true.
This property was introduced in QtDataVisualization 1.2.
Access functions:
| bool | isRotationEnabled() const |
| void | setRotationEnabled() |
Notifier signal:
| void | rotationEnabledChanged() |
[since QtDataVisualization 1.2] selectionEnabled : bool
This property holds whether this input handler allows selection from the graph.
Defaults to true.
This property was introduced in QtDataVisualization 1.2.
Access functions:
| bool | isSelectionEnabled() const |
| void | setSelectionEnabled() |
Notifier signal:
| void | selectionEnabledChanged() |
[since QtDataVisualization 1.2] zoomAtTargetEnabled : bool
This property holds whether zooming should change the camera target so that the zoomed point of the graph stays at the same location after the zoom.
Defaults to true.
This property was introduced in QtDataVisualization 1.2.
Access functions:
| bool | isZoomAtTargetEnabled() const |
| void | setZoomAtTargetEnabled() |
Notifier signal:
| void | zoomAtTargetEnabledChanged() |
[since QtDataVisualization 1.2] zoomEnabled : bool
This property holds whether this input handler allows graph zooming.
Defaults to true.
This property was introduced in QtDataVisualization 1.2.
Access functions:
| bool | isZoomEnabled() const |
| void | setZoomEnabled() |
Notifier signal:
| void | zoomEnabledChanged() |
Member Function Documentation
[virtual] Q3DInputHandler::~Q3DInputHandler()
Destroys the input handler.