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 see the "Page Init" event, as they are created after the event. The WebChartViewer requires seeing this event for certain functions. If you are creating WebChartViewer controls dynamically, please refer to WebChartViewer.OnPageInit on how to properly initialize the WebChartViewer controls.

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

The followings list out the members that are specific to the WebChartViewer control. 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	Determine the sizing method of the WebChartViewer control.
ImageSessionId	The session variable name used to temporarily store the chart image.
ViewPortLeft	Gets or sets the position of the left side of the view port.
ViewPortTop	Gets or sets the position of the top side of the view port.
ViewPortWidth	Gets or sets the width of the view port.
ViewPortHeight	Gets or sets the height of the view port.
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 view port width at maximum zoom in.
ZoomOutWidthLimit	Gets or sets the view port width at maximum zoom out.
ZoomInHeightLimit	Gets or sets the view port height at maximum zoom in.
ZoomOutHeightLimit	Gets or sets the view port 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	Connects the WebChartViewer system to the Web Form to support dynamically created WebChartViewer controls.
GetPostBackURL	Creates a special URL to represent post back operation for use in image maps.
MakeDelayedMap	Creates a delayed image map suitable for use in JsChartViewer.
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.
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 image out as a MIME stream of image type.
SetCustomAttr	Sets a custom attribute.
GetCustomAttr	Gets a custom attribute.
setFullRange	Defines the full range of a view port data scale.
getValueAtViewPort	Converts a view port coordinate to a value of the specified data scale.
getViewPortAtValue	Converts a value of the specified data scale to a view port coordinate.
syncLinearAxisWithViewPort	Synchronizes a linear Axis with the part of the data scale in view port.
syncLogAxisWithViewPort	Synchronizes a logarithmic Axis with the part of the data scale in view port.
syncDateAxisWithViewPort	Synchronizes a date/time Axis with the part of the data scale in view port.
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 view port is changed by mouse actions in the browser side Javascript ChartViewer (JsChartViewer).
Note: Events inherited from System.Web.UI.WebControls.Image are omitted.