MACROMEDIA DREAMWEAVER MX 2004-DREAMWEAVER API, Reference

Page: 279 / 486

Selection functions 279
dreamweaver.relativeToAbsoluteURL()
Availability
Dreamweaver 2.
Description
Given a relative URL and a point of reference (either the path to the current document or the site
root), this function converts the relative URL to an absolute file:// URL.
Arguments
docPath
,
siteRoot, relURL
•
The
docPath
argument is the path to a document on the user’s computer (for example, the
current document), which is expressed as a file:// URL or an empty string if
relURL
is a root-
relative URL.
•
The
siteRoot
argument is the path to the site root, which is expressed as a file:// URL or an
empty string if
relURL
is a document-relative URL.
•
The
relURL
argument is the URL to convert.
Returns
An absolute URL string. The return value is generated, as described in the following list:
•
If
relURL
is an absolute URL, no conversion occurs, and the return value is the same
as
relURL
.
•
If
relURL
is a document-relative URL, the return value is the combination of
docPath
+
relURL
.
•
If
relURL
is a root-relative URL, the return value is the combination of
siteRoot
+
relURL
.
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 220 .
dom.getSelectedNode()
Availability
Dreamweaver 3.
Description
Gets the selected node. Using this function is equivalent to calling the
dom.getSelection()
function and passing the return value to the
dom.offsetsToNode()
function.
Arguments
None.
Returns
The tag, text, or comment object that completely contains the specified range of characters.
000_DW_API_Print.book Page 279 Wednesday, August 20, 2003 9:14 AM