Contents Index Topic Contents
	Previous Topic: IHTMLAreaElement::get_search Next Topic: IHTMLAreaElement::get_tabIndex

IHTMLAreaElement::get_shape

HRESULT get_shape(
    BSTR *p
);

Retrieves the type of shape used in the image map.

• Returns S_OK if successful, or an error value otherwise.

p

Address of a string variable that receives one of the following strings:

"circ"
"circle"
"poly"
"polygon"
"rect"
"rectangle"

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.

See also put_shape

 Top of Page

---

IHTMLAreaElement::put_shape

HRESULT put_shape(
    BSTR v
);

Sets the type of shape used in the image map.

• Returns S_OK if successful, or an error value otherwise.

v

String value specifying the shape. Can be one of these values:

"circ"
"circle"
"poly"
"polygon"
"rect"
"rectangle"

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.

See also get_shape

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.