IHTMLAreaElement::get_shape Method

---

Retrieves the type of shape used in the image map.

Syntax

HRESULT get_shape(
    BSTR *p
);

Parameters

p

Address of a string (BSTR) variable that receives the shape. For details, see the shape property.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

Each shape causes the coords property of the AREA object to take a different set of values. The relationships are as follows:

RECT	Rectangle. Takes four coordinates: x1, y1, x2, and y2.
RECTANGLE	Rectangle. Takes four coordinates: x1, y1, x2, and y2.
CIRC	Circle. Takes three coordinates: centerx, centery, and radius.
CIRCLE	Circle. Takes three coordinates: centerx, centery, and radius.
POLY	Polygon. Takes three or more pairs of coordinates denoting a polygonal region.
POLYGON	Polygon. Takes three or more pairs of coordinates denoting a polygonal region.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

---

IHTMLAreaElement::put_shape Method

---

Sets the type of shape used in the image map.

Syntax

HRESULT put_shape(
    BSTR v
);

Parameters

v

String (BSTR) value that specifies the shape to set. For details, see the shape property.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

Each shape causes the coords property to take a different set of values. The relationships are described as follows:

RECT	Rectangle. Takes four coordinates: x1, y1, x2, and y2.
RECTANGLE	Rectangle. Takes four coordinates: x1, y1, x2, and y2.
CIRC	Circle. Takes three coordinates: centerx, centery, and radius.
CIRCLE	Circle. Takes three coordinates: centerx, centery, and radius.
POLY	Polygon. Takes three or more pairs of coordinates denoting a polygonal region.
POLYGON	Polygon. Takes three or more pairs of coordinates denoting a polygonal region.

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0