Q3DInputHandler Class

Basic wheel mouse based input handler. More...

Header: #include <Q3DInputHandler>
qmake: QT += datavisualization
Since: QtDataVisualization 1.0
Instantiated By: InputHandler3D
Inherits: QAbstract3DInputHandler
Inherited By:

QTouch3DInputHandler

This class was introduced in QtDataVisualization 1.0.

Properties

Public Functions

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)

Signals

void rotationEnabledChanged(bool enable)
void selectionEnabledChanged(bool enable)
void zoomAtTargetEnabledChanged(bool enable)
void zoomEnabledChanged(bool enable)

Detailed Description

Q3DInputHandler is the basic input handler for wheel mouse type of input devices.

Default input handler has the following functionalty:

Mouse actionAction
Drag with right button pressedRotate graph within limits set for Q3DCamera.
Left clickSelect item under cursor or remove selection if none. May open the secondary view depending on the selection mode.
Mouse wheelZoom in/out within the allowable zoom range set for Q3DCamera.
Left click on the primary view when the secondary view is visibleCloses 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

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(bool enable)

Notifier signal:

void rotationEnabledChanged(bool enable)

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(bool enable)

Notifier signal:

void selectionEnabledChanged(bool enable)

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(bool enable)

Notifier signal:

void zoomAtTargetEnabledChanged(bool enable)

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(bool enable)

Notifier signal:

void zoomEnabledChanged(bool enable)