Specifications

546
Selection functions
Selection functions get and set the selection in open documents. For information on getting or
setting the selection in the Site panel, see “Site functions” on page 558.
dom.getSelectedNode()
Availability
Dreamweaver 3
Description
Gets the selected node. Using this function is equivalent to calling dom.getSelection() and
passing the return value to
dom.offsetsToNode().
Arguments
None.
Returns
The tag, text, or comment object that completely contains the specified range of characters.
dom.getSelection()
Availability
Dreamweaver 3
Description
Gets the selection, which is expressed as character offsets into the document’s source code.
Arguments
bAllowMultiple
• bAllowMultiple 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, this function returns an array that contains two integers. The first integer is
the character offset of the beginning of the selection. The second integer is the character offset of
the end 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 beginning 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 end 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 are returned. The selection never includes the
TR
tags.
dom.nodeToOffsets()
Availability
Dreamweaver 3