WebChartViewer

The WebChartViewer control is a Web Forms control for viewing charts and for handling advanced chart user interactions. It is a subclass of the ASP.NET Image control.

The WebChartViewer control enhances the Image control in the following ways:

Dynamic In-Memory Image Support

The WebChartViewer control is specifically designed to support dynamic chart images created in memory, without having to create image files on disk.
Image Map Support

The WebChartViewer control supports client side image maps. This allows the chart image to response to client side mouse events, such as displaying tool tips when the mouse moves over the "hot spots" on the chart, or response to mouse clicks on the hot spots.
Post Back Events Support

In HTML, an image map is like a collection of <A> tags. Each hot spot behaves like a hypertext link, which can be used to jump to another URL.

The WebChartViewer control also supports post back events for hot spots, which means the hot spots act like ASP.NET Buttons. When clicked, WebChartViewer.ClickHotSpot event will be fired on the server side.
JsChartViewer Support

The JsChartViewer control is a browser side Javascript control for supporting advanced chart user interactions, such as programming track cursors, zooming and scrolling and AJAX chart updates. WebChartViewer acts as the server side counterpart to JsChartViewer. It provides the necessary information to JsChartViewer, and handles the AJAX chart update requests and responses between the server and the browser.

Normally, controls are specified at design time by using ASP.NET tags, or by dragging and dropping the controls onto the Web Form in Visual Studio.

However, some applications may create controls dynamically on the fly during runtime (eg. during the Page Load event of the Web Form). In this case, the controls may not receive the "Page Init" event, as they are created after the event. The WebChartViewer requires this event for certain functions. If you are creating WebChartViewer on or after the Page Init event, please refer to WebChartViewer.OnPageInit on how to perform these functions in the Page Init event before the control is created.

In addition to sending chart images directly from memory to the browser, WebChartViewer also supports storing the chart images as image files first, and sending the links to those files to the browser. Please refer to ASP.NET Output Methods with Viewers for additional information.

The followings list out the members that are specific to WebChartViewer. Members inherited from the Image control are omitted. Please refer to Microsoft .NET documentation for members of the Image control.

Properties

Name	Description
Image	Represent the chart image to be viewed.
ImageMap	Gets or sets the image map associated with the chart.
ChartModel	Gets or sets the Javascript Chart Model of the chart for the purpose of support track cursors.
ChartMetrics	Gets or sets the chart metrics of the chart.
ChartSizeMode	Determines the sizing method of the WebChartViewer control.
ContentDisposition	The suggested filename to use when user saves the chart image as a file on the browser side.
ImageSessionId	The name of the session variable to temporarily store the chart image.
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 HTML color.
ZoomInCursor	Gets or sets the mouse cursor to be used when the mouse is used for zoom in.
ZoomOutCursor	Gets or sets the mouse cursor to be used when the mouse is used for zoom out.
NoZoomCursor	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.
ScrollCursor	Gets or sets the mouse cursor to be used when the mouse is used for scrolling.
Note: Properties inherited from System.Web.UI.WebControls.Image are omitted.

Methods

Name	Description
OnPageInit	Handles the Web Form Init event to support dynamically created WebChartViewer or WebViewPortControl.
GetPostBackURL	Creates a special URL to represent post back operation for use in image maps.
IsPartialUpdateRequest	Checks if the current HTTP Request is a partial update request (AJAX request) sent using JsChartViewer.partialUpdate.
IsStreamRequest	Checks if the current HTTP request is a stream update request sent using JsChartViewer.streamUpdate.
IsAttachmentRequest	Checks if the current partial update request (AJAX request) is an attachment request sent using JsChartViewer.partialUpdateAsAttachment.
IsViewPortChangedEvent	Checks if the JsChartViewer.ViewPortChanged event has occurred.
GetSenderClientId	Gets the id of the JsChartViewer that sends the current HTTP request.
LoadViewerState	Loads the state of the JsChartViewer into the WebChartViewer in partial chart updates (AJAX chart updates).
PartialUpdateChart	Sends the response to a partial chart update request.
StreamChart	Sends the chart out as a MIME stream.
StreamImage	Sends the image out as a MIME stream.
SetCustomAttr	Sets a custom attribute.
GetCustomAttr	Gets a custom attribute.
setFullRange	Defines the full range of a viewport data scale.
getValueAtViewPort	Converts a viewport coordinate to a value of the specified data scale.
getViewPortAtValue	Converts a value of the specified data scale to a viewport coordinate.
syncLinearAxisWithViewPort	Synchronizes a linear Axis with the part of the data scale in viewport.
syncLogAxisWithViewPort	Synchronizes a logarithmic Axis with the part of the data scale in viewport.
syncDateAxisWithViewPort	Synchronizes a date/time Axis with the part of the data scale in viewport.
Note: Methods inherited from System.Web.UI.WebControls.Image are omitted.

Events

Name	Description
ClickHotSpot	This event occurs when the mouse is clicked on a hot spot of the chart image.
ViewPortChanged	This event occurs when the viewport is changed by mouse actions in the browser side Javascript ChartViewer (JsChartViewer).
Note: Events inherited from System.Web.UI.WebControls.Image are omitted.