areas Collection

Internet Development Index

---

Retrieves a collection of the area objects defined for the given map object.

Syntax

[ oColl = ] MAP.areas

[ oObject = ] MAP.areas(vIndex [, iSubIndex])

Possible Values

oColl	Array of area objects.
oObject	Reference to an individual item in the array of elements contained by the object.
vIndex	Required. Integer or string that specifies the element or collection to retrieve. If this parameter is an integer, the method returns the element in the collection at the given position, where the first element has value 0, the second has 1, and so on. If this parameter is a string and there is more than one element with the name or id property equal to the string, the method returns a collection of matching elements.
iSubIndex	Optional. Position of an element to retrieve. This parameter is used when vIndex is a string. The method uses the string to construct a collection of all elements that have a name or id property equal to the string, and then retrieves from this collection the element at the position specified by iSubIndex.

Members Table

The following table lists the members exposed by the areas object. Click a tab on the left to choose the type of member you want to view.

Attributes/Properties

Property	Description
length	Sets or retrieves the number of objects in a collection.

Methods

Method	Description
add	Adds an element to the areas, controlRange, or options collection.
item	Retrieves an object from the all collection or various other collections.
namedItem	Retrieves an object or a collection from the specified collection.
remove	Removes an element from the collection.
tags	Retrieves a collection of objects that have the specified HTML tag name.
urns	Retrieves a collection of all objects to which a specified behavior is attached.

Remarks

Areas can be added to or removed from the collection. If duplicate identifiers are found, a collection of those items is returned. Collections of duplicates must be referenced subsequently by ordinal position.

Use of the Area operator is not supported for adding areas to the collection. Instead, use the createElement and add methods. Alternatively, use the insertAdjacentHTML method.

Standards Information

This collection is defined in World Wide Web Consortium (W3C) Document Object Model (DOM) Level 1 .

Applies To

	MAP