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.
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 |
---|---|
|
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
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.
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