This class represents a collection of MapArea objects.
MapAreasCollection class is a strongly typed collection of MapAreas
Visual Basic (Declaration) | |
---|---|
Public Class MapAreasCollection |
Visual Basic (Usage) | Copy Code |
---|---|
|
C# | |
---|---|
public class MapAreasCollection |
The MapAreasCollection class represents a collection of MapArea objects, which in turn represent map areas of a client-side image map (e.g. html <AREA> tags).
This class is used in two ways:
- As the MapAreas property (of the root Chart object), which is used for custom map areas. These custom map areas have a user-defined shape and coordinates, and can be added at either design-time or at run-time using the overloaded Add or Insert methods.
- In the CustomizeMapAreas event, as the MapAreaItems property of the CustomizeMapAreasEventArgs parameter. This MapAreaItems property stores MapArea objects that have automatically been created for a chart object (map areas are automatically created when an applicable chart element (e.g. data point, series, legend item or stripline object) has a non-empty ToolTip, Href or MapAreaAttributes property. In this case the dimensions and location of a map area are determined by the chart element.
The MapAreasItems property allows for the deletion or modification of these automatically generated map areas, and can also be used to add custom map areas.
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.
System.Object
Dundas.Charting.WebControl.MapAreasCollection
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