ChartViewer

The ChartViewer control is an ActiveX control for viewing ChartDirector charts. It is a subclass of the VB6 UserControl. Apart from displaying the charts, its main functions are to support advanced user interactions with the charts, including:

Hot Spot Support

The ChartViewer control displays tooltips and fires "hot spot mouse events" for hot spots when the mouse is moving or clicking on the hot spot. In the event handler, it provides information about the hot spot that triggers the event.

The hot spots, with attributes and tool tips, are defined using standard HTML image map format. The BaseChart.getHTMLImageMap method can be used to automatically generate image maps for charts. You may also add your own custom hot spots by appending additional image map to the image map generated by BaseChart.getHTMLImageMap.
Zoom and Scroll Support

The ChartViewer control includes special methods and events for supporting using mouse clicks and drags to control the "viewport". There are also methods for synchronizing the axis scales with the viewport.

The followings are members specific to the ChartViewer control. Members inherited from the VB6 UserControl are omitted. Please refer to Microsoft documentation for members of the VB6 UserControl.

Properties

Name	Description
Chart	Gets or sets a BaseChart object for display with the ChartViewer.
Picture	Gets or sets the chart image to view. The chart image is typically created using BaseChart.makePicture.
AutoSize	Gets or sets the sizing method of the ChartViewer control.
ImageMap	Gets or sets the image map that defines the hot spots on the chart image.
ToolTipText	Gets or sets the tool tip to display when the mouse is not over a hot spot.
ViewPortLeft	Gets or sets the position of the left side of the viewport.
ViewPortTop	Gets or sets the position of the top side of the viewport.
ViewPortWidth	Gets or sets the width of the viewport.
ViewPortHeight	Gets or sets the height of the viewport.
MouseUsage	Gets or sets the mouse usage mode.
ZoomDirection	Gets or sets the zoom direction for mouse zoom in/out actions.
ScrollDirection	Gets or sets the scroll direction for mouse scroll actions.
ZoomInRatio	Gets or sets the magnification ratio for each zoom in click of the mouse.
ZoomOutRatio	Gets or sets the magnification ratio for each zoom out click of the mouse.
ZoomInWidthLimit	Gets or sets the viewport width at maximum zoom in.
ZoomOutWidthLimit	Gets or sets the viewport width at maximum zoom out.
ZoomInHeightLimit	Gets or sets the viewport height at maximum zoom in.
ZoomOutHeightLimit	Gets or sets the viewport height at maximum zoom out.
MinimumDrag	Gets or sets the minimum mouse drag distance before it is considered as an intentional drag.
SelectionBorderWidth	Gets or sets the border width of the zoom selection box.
SelectionBorderColor	Gets or sets the border color of the zoom selection box as an OLE_COLOR.
MousePointer	Gets or sets the mouse pointer to be used when the mouse is not over a normal hot spot.
MouseIcon	Gets or sets a custom mouse icon to be used when the mouse is not over a normal hot spot.
HotSpotMousePointer	Gets or sets the mouse pointer to be used when the mouse is over a normal hot spot.
HotSpotMouseIcon	Gets or sets a custom mouse icon to be used when the mouse is over a normal hot spot.
ZoomInMousePointer	Gets or sets the mouse cursor to be used when the mouse is used for zoom in.
ZoomInMouseIcon	Gets or sets a custom mouse icon to be used when the mouse is used for zoom in.
ZoomOutMousePointer	Gets or sets the mouse cursor to be used when the mouse is used for zoom out.
ZoomOutMouseIcon	Gets or sets a custom mouse icon to be used when the mouse is used for zoom out.
NoZoomMousePointer	Gets or sets the mouse cursor to be used when the mouse is used for zoom in/out, but the zoom in/out limits has been reached.
NoZoomMouseIcon	Gets or sets a custom mouse icon to be used when the mouse is used for zoom in/out, but the zoom in/out limits has been reached.
ScrollMousePointer	Gets or sets the mouse cursor to be used when the mouse is used for scrolling.
ScrollMouseIcon	Gets or sets a custom mouse icon to be used when the mouse is used for scrolling.
UpdateInterval	Gets or sets the minimum gap interval between two ViewPortChanged events in milliseconds.
IsInViewPortChangedEvent	Checks if the current code is executing in a ViewPortChanged event.
Note: Properties inherited from UserControl are omitted.

Methods

Name	Description
validateViewPort	Ensures the viewport left, top, width and height are within valid ranges and adjusts them if necessary.
updateViewPort	Triggers the ViewPortChanged event.
Note: Methods inherited from UserControl are omitted.

Events

Name	Description
ClickHotSpot	This event occurs when the mouse clicks on a hot spot on the chart image.
DblClickHotSpot	This event occurs when the mouse double clicks on a hot spot on the chart image.
MouseMoveHotSpot	This event occurs when the mouse cursor is moved over a hot spot on the chart image.
MouseDownHotSpot	This event occurs when the mouse cursor is over a hot spot on the chart image and the mouse button is pressed.
MouseUpHotSpot	This event occurs when the mouse cursor is over a hot spot on the chart image and the mouse button is released.
ViewPortChanged	This event occurs when the viewport is changed using mouse actions (see ChartViewer.MouseUsage), or when ChartViewer.updateViewPort is called.
Note: Events inherited from UserControl are omitted.