ChartDirector 7.0 (Java Edition)

ChartViewer.setMouseUsage


Usage

public void setMouseUsage(int mouseUsage)

Description

Sets the mouse usage mode.

The following table describes the supported mouse usage modes and the mouse behaviour in each mode.

ConstantValueDescription
MouseUsageDefault0This represents the default mouse behaviour, which is to support tool tips and hot spot events as defined by the image map.

See ChartViewer.setImageMap on how to define an image map for a chart.
MouseUsageScrollOnDrag1The mouse is used for drag scrolling the chart.

In addition to the default mouse behaviour, when the mouse drags on the plot area, the mouse cursor will change to a scroll cursor, the viewport coordinates will shift to reflect the amount dragged, and ViewPortChanged events will be fired.
MouseUsageScrollOnDrop2The mouse is used for drag scrolling the chart.

In addition to the default mouse behaviour, when the mouse drags on the plot area, the mouse cursor will change to a scroll cursor, and a selection rectangle representing the shifted plot area will be displayed to reflect the amount dragged. When the mouse is released, the viewport coordinates will be updated to reflect the amount dragged, and a ViewPortChanged event will be fired.
MouseUsageZoomIn3The mouse is used for zoom in actions.

In addition to the default mouse behaviour, when the mouse is inside the plot area, the following behaviour will apply:

  • The mouse cursor will change to a zoom in cursor (a magnifying glass cursor with a '+' sign inside).

  • When the mouse drags on the plot area, a selection rectangle will be visible. When the mouse button is subsequently released, the viewport coordinates will be updated to reflect the selection rectangle, and a ViewPortChanged event will be fired.

  • When the mouse clicks on the plot area without dragging, the viewport will be updated to reflect zooming into the clicked point by a ratio specified in ChartViewer.setZoomInRatio, and a ViewPortChanged event will be fired.
MouseUsageZoomOut4The mouse is used for zoom out actions.

In addition to the default mouse behaviour, when the mouse is inside the plot area, the following behaviour will apply:

  • The mouse cursor will change to a zoom out cursor (a magnifying glass cursor with a '-' sign inside).

  • When the mouse clicks on the plot area , the viewport will be updated to reflect zooming out from the clicked point by a ratio specified in ChartViewer.setZoomOutRatio, and a ViewPortChanged event will be fired.

Arguments

ArgumentDefaultDescription
mouseUsage(Mandatory)The mouse usage mode of the control, which must be one of the predefined constants as shown in the table above.

Return Value

None