Dundas Chart for ASP.NET
MapArea Class
Members  See Also  Send comments on this topic.
Dundas.Charting.WebControl Namespace : MapArea Class


Represents a map area, and is stored in the MapAreasCollection class.


MapArea class represents an area of the chart with end-user interactivity like tooltip, HREF or custom attributes.

Syntax

Visual Basic (Declaration)  
Public Class MapArea 
   Implements A 
Visual Basic (Usage) Copy Code
Dim instance As MapArea
C#  
public class MapArea : A  

Remarks

The MapArea class represents a map area of a client-side image map, and corresponds to an html <AREA> tag.

MapArea objects are stored using the MapAreasCollection class.

There are two types of MapArea objects:

  • Map areas that are automatically created when a chart element (e.g. data point, series, legenditem or stripline object) has a non-empty ToolTip, Href or MapAreaAttributes property (note that other html elements necessary for a client-side image map are also created). In this case the dimensions and location of a map area are automatically determined by the chart element.

    These map areas may be deleted or modified at run-time using the CustomizeMapAreas event of the root Chart object.

  • Custom map areas that have a user-defined shape and coordinates. These custom map areas can be added at either design-time or run-time using the Chart object's MapAreas property.

A client-side image map will only be created at run-time if the MapEnabled property of the root Chart object is true (the default).

Important: To create an image map using the previously described MapArea objects the RenderType property of the Chart object MUST be RenderType.ImageTag. It is possible to create an image map when using binary streaming, but a special technique must be used. Refer to the Client-Side Mapping and Binary Streaming  topic for further details.

For custom MapArea objects the Shape property determines the shape, while the Coordinates property determines the location of the map area.

A tooltip, hyperlink and attributes (e.g. "target=_Blank", "OnClick="javascript:MyJavaScriptFunction()" can be set for all map areas.

Use the Custom property to determine if a map area is a custom MapArea object (e.g. has user-defined shape and coordinates).

Inheritance Hierarchy

System.Object
   Dundas.Charting.WebControl.MapArea

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

Copyright © 2001 - 2009 Dundas Data Visualization, Inc. and others.