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


This class represents a collection of MapArea objects.


MapAreasCollection class is a strongly typed collection of MapAreas

Object Model

Syntax

Visual Basic (Declaration)  
Public Class MapAreasCollection 
Visual Basic (Usage) Copy Code
Dim instance As MapAreasCollection
C#  
public class MapAreasCollection 

Remarks

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.

Inheritance Hierarchy

System.Object
   Dundas.Charting.WebControl.MapAreasCollection

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.