Public Overloads Function Add( _
   ByVal toolTip As String, _
   ByVal href As String, _
   ByVal attr As String, _
   ByVal path As GraphicsPath _
) As Integer

Visual Basic (Usage)	Copy Code
Dim instance As MapAreasCollection Dim toolTip As String Dim href As String Dim attr As String Dim path As GraphicsPath Dim value As Integer   value = instance.Add(toolTip, href, attr, path)

public int Add( 
   string toolTip,
   string href,
   string attr,
   GraphicsPath path
)

Parameters

toolTip

The tooltip of the map area, which corresponds to the html <AREA> tag's Title attribute. Multi-line tooltips can be used using a carriage return/line feed (e.g. vbCrLf for VB).

Tool tip.

href

The destination URL or anchor point of the map area. Corresponds to the html <AREA> tag's HREF attribute.

Jump URL.

attr

One or more map area attributes. The entire string expression is appended at the end of the <AREA> tag.

Other area attributes.

path

A GraphicsPath object that defines the shape of the map area.

Area coordinates as graphis path

Return Value

An integer that represents the index where the item was inserted into the collection (0-based).

The following sample creates a map area in the shape of a triangle. The GraphicsPath object allows us to specify map areas using a shape other than the pre-defined rectangles, circles and polygons.

Visual Basic

Copy Code

'declare variables Dim myGraphicsPath As New System.Drawing.Drawing2D.GraphicsPath() Dim point1 As Drawing.PointF Dim point2 As Drawing.PointF Dim point3 As Drawing.PointF 'set the coordinates of PointF structures that will define the triangle point1.X = 20 point1.Y = 20 point2.X = 50 point2.Y = 80 point3.X = 80 point3.Y = 20 'add lines to the GraphicsPath object for triangle myGraphicsPath.AddLine(point1, point2) myGraphicsPath.AddLine(point2, point3) myGraphicsPath.AddLine(point3, point1) 'add map area, using the GraphicsPath object that defines the triangle Chart1.MapAreas.Add ("Tooltip1" & vbCrLf & "Tooltip2", "http://www.SomeDomain.com", "Target=_Blank", myGraphicsPath)

Appends a custom MapArea object to the end of the collection, using the specified parameters to set the map area properties.

Chart coordinates are used when setting the position of the rectangle. "0,0" represents the top-left corner of the chart image and "100,100" represents the bottom-right corner of the chart image. To find out more about the chart's coordinate system see the Chart Coordinate System topic.

IMPORTANT: To create an image map this way the RenderType property of the Chart object MUST be RenderType.ImageTag. It is possible to create an image map when using binary streaming, but another technique must be used. Refer to the Client-Side Mapping and Binary Streaming  topic for further details.

The attr parameter is used for map attributes such as "Target=_Blank", "OnClick="javascript:MyJavaScriptFunction()", etc.

Use this definition when the map area needs to be a shape other than a circle, rectangle or polygon.

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

Reference