User Guide

Selection functions 337
dom.getSelection()
Availability
Dreamweaver 3.
Description
Gets the selection, which is expressed as character offsets into the document’s source code.
Arguments
{bAllowMultiple}
■ The bAllowMultiple argument, which is optional, is a Boolean value that indicates
whether the function should return multiple offsets if more than one table cell, image map
hotspot, or layer is selected.
If this argument is omitted, it defaults to
false.
Returns
For simple selections, an array that contains two integers. The first integer is the character
offset of the opening of the selection. The second integer is the character offset at the closing
of the selection. If the two numbers are the same, the current selection is an insertion point.
For complex selections (multiple table cells, multiple layers, or multiple image map hotspots),
an array that contains 2
n integers, where n is the number of selected items. The first integer in
each pair is the character offset of the opening of the selection (including the opening
TD, DIV,
SPAN, LAYER, ILAYER, or MAP tag); the second integer in each pair is the character offset of the
closing of the selection (including the closing
TD, DIV, SPAN, LAYER, ILAYER, or MAP tag). If
multiple table rows are selected, the offsets of each cell in each row return. The selection never
includes the
TR tags.
dom.nodeToOffsets()
Availability
Dreamweaver 3.
Description
Gets the position of a specific node in the DOM tree, which is expressed as character offsets
into the document’s source code. It is valid for any document on a local drive.
000_DW_API_Print.book Page 337 Wednesday, July 20, 2005 11:58 AM