ChartDirector 7.1 (.NET Edition)

WinChartViewer.MouseUsage


Declaration

[C#]public WinChartMouseUsage MouseUsage {get; set;};
[VB]Public Property MouseUsage As WinChartMouseUsage

Description

Gets or sets the mouse usage mode.

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

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

See WinChartViewer.ImageMap on how to define an image map for a chart.
WinChartMouseUsage.ScrollOnDrag1The 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.
WinChartMouseUsage.ScrollOnDrop2The mouse is used for drag scrolling the chart.

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.

If the mouse is not dragging inside the plot area, its behaviour is the same as the default mouse behaviour.
WinChartMouseUsage.ZoomIn3The mouse is used for zoom in actions.

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 WinChartViewer.ZoomInRatio, and a ViewPortChanged event will be fired.
If the mouse is not inside the plot area, its behaviour is the same as the default mouse behaviour.
WinChartMouseUsage.ZoomOut4The mouse is used for zoom out actions.

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 WinChartViewer.ZoomOutRatio, and a ViewPortChanged event will be fired.
If the mouse is not inside the plot area, its behaviour is the same as the default mouse behaviour.