Dundas Chart for ASP.NET
Insert(Int32,MapAreaShape,String,Single[]) Method
See Also  Send comments on this topic.
Dundas.Charting.WebControl Namespace > MapAreasCollection Class > Insert Method : Insert(Int32,MapAreaShape,String,Single[]) Method


index

The index value where the item will be inserted (0-based).


Index to insert at.
shape

A MapAreaShape enumeration value that determines the shape of the map area. Can be a circle, rectangle or polygon. The coord parameter determines its coordinates.


Area shape.
href

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


Jump URL.
coord

Coordinates array that determines the location of the circle, rectangle or polygon. The type of shape that is being used determines the type of coordinates required. See below for further details.


Array of coordinates

Inserts a custom MapArea object into the MapAreasCollection, allowing for a shape, hyperlink and array of coordinates.


Insert new map area item into the collection.

Syntax

Visual Basic (Declaration)  
Public Overloads Sub Insert( _
   ByVal index As Integer, _
   ByVal shape As MapAreaShape, _
   ByVal href As String, _
   ByVal coord() As Single _
) 
Visual Basic (Usage) Copy Code
Dim instance As MapAreasCollection
Dim index As Integer
Dim shape As MapAreaShape
Dim href As String
Dim coord() As Single
 
instance.Insert(index, shape, href, coord)
C#  
public void Insert( 
   int index,
   MapAreaShape shape,
   string href,
   float[] coord
)

Parameters

index

The index value where the item will be inserted (0-based).


Index to insert at.
shape

A MapAreaShape enumeration value that determines the shape of the map area. Can be a circle, rectangle or polygon. The coord parameter determines its coordinates.


Area shape.
href

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


Jump URL.
coord

Coordinates array that determines the location of the circle, rectangle or polygon. The type of shape that is being used determines the type of coordinates required. See below for further details.


Array of coordinates

Remarks

The coord array parameter determines the coordinates of the map area shape, and is dependent on the shape being used:

  • Circle. Three coordinates must be provided: "x1,y1,r". "x1" and "y1" determine the center of the circle, and "r" is the radius of the circle.
  • Rectangle. Four coordinates must be provided: "x1,y1,x2,y2". "x1,y1" are the coordinates of the upper-left corner of the rectangle, and "x2,y2" are the coordinates of the lower-right corner of the rectangle.
  • Polygon. Two or more x,y pairs must be provided: "x1,y1,x2,y2...xn,yn". Each x,y pair determines the coordinates of one vertex of the polygon.

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.