Layer and image map functions

Layer and image map functions handle aligning, resizing, and moving layers and image map hotspots. The function description indicates if it applies to layers or to hotspots.

dom.align()

Availability

Dreamweaver 3.

Description

Aligns the selected layers or hotspots left, right, top, or bottom.

Arguments

 alignDirection 

• The alignDirection argument is a string that specifies the edge to align with the layers or hotspots ("left", "right", "top", or "bottom").

Returns

Nothing.

Enabler

See "dom.canAlign()" on page 1055.

dom.arrange()

Availability

Dreamweaver 3.

Description

Moves the selected hotspots in the specified direction.

Arguments

 toBackOrFront 

• The toBackOrFront argument is the direction in which the hotspots must move, either front or back.

Returns

Nothing.

Enabler

See "dom.canArrange()" on page 1056.

dom.makeSizesEqual()

Availability

Dreamweaver 3.

Description

Makes the selected layers or hotspots equal in height, width, or both. The last layer or hotspot selected is the guide.

Arguments

 bHoriz, bVert 

• The bHoriz argument is a Boolean value that indicates whether to resize the layers or hotspots horizontally.

• The bVert argument is a Boolean value that indicates whether to resize the layers or hotspots vertically.

Returns

Nothing.

dom.moveSelectionBy()

Availability

Dreamweaver 3.

Description

Moves the selected layers or hotspots by the specified number of pixels horizontally and vertically.

Arguments

 x, y 

• The x argument is the number of pixels that the selection must move horizontally.

• The y argument is the number of pixels that the selection must move vertically.

Returns

Nothing.

dom.resizeSelectionBy()

Availability

Dreamweaver 3.

Description

Resizes the currently selected layer or hotspot.

Arguments

 left, top, bottom, right 

• The left argument is the new position of the left boundary of the layer or hotspot.

• The top argument is the new position of the top boundary of the layer or hotspot.

• The bottom argument is the new position of the bottom boundary of the layer or hotspot.

• The right argument is the new position of the right boundary of the layer or hotspot.

Returns

Nothing.

Example

If the selected layer has the Left, Top, Width, and Height properties shown, calling dw.getDocumentDOM().resizeSelectionBy( 10, 30,30,10) is equivalent to resetting Left to 40, Top to 20, Width to 240, and Height to 240.

dom.setLayerTag()

Availability

Dreamweaver 3.

Description

Specifies the HTML tag that defines the selected layer or layers.

Arguments

 tagName 

• The tagName argument must be "layer", "ilayer", "div", or "span".

Returns

Nothing.