beautypg.com

Dreamweaver.getelementref() – Adobe Dreamweaver API Reference CS5 User Manual

Page 273

background image

268

DREAMWEAVER API REFERENCE

Document

Last updated 8/27/2013

Description
Uses the internal Dreamweaver URL decoding mechanism to decode special characters and symbols in URL strings.
For example, this function decodes

%20

to a space character and the name

"

to ".

Arguments

inStr

The

inStr

argument is the string to decode.

Returns
A string that contains the decoded URL.

Example
The following example calls

dw.doURLDecoding()

to decode the special characters in its argument and store the

resulting string in

outstr

:

outStr = dreamweaver.doURLDecoding("http://maps.yahoo.com/py/ddResults.py?Pyt= ¬

Tmap&tarname=&tardesc=&newname=&newdesc=&newHash=&newTHash=&newSts=&newTSts=&tlt=&tln= ¬
&slt=&sln=&newFL=Use+Address+Below&newaddr=2000+Shamrock+Rd&newcsz=Metroo+Park%2C+CA& ¬
newcountry=us&newTFL=Use+Address+Below&newtaddr=500+El+Camino&newtcsz=Santa+Clara%2C+CA& ¬
newtcountry=us&Submit=Get+Directions")

dreamweaver.getElementRef()

Availability
Dreamweaver 2.

Description
Gets the Netscape Navigator or Internet Explorer object reference for a specific tag object in the DOM tree.

Arguments
NSorIE, tagObject

The NSorIE argument must be either

"NS 4.0"

or

"IE 4.0"

. The DOM and rules for nested references differ in

Netscape Navigator 4.0 and Internet Explorer 4.0. This argument specifies for which browser to return a valid
reference.

The tagObject argument is a tag object in the DOM tree.

Returns
A string that represents a valid JavaScript reference to the object, such as

document.layers['myLayer']

. The string

is subject to the following conditions:

Dreamweaver returns correct references for Internet Explorer for

A

,

AREA

,

APPLET

,

EMBED

,

DIV

,

SPAN

,

INPUT

,

SELECT

,

OPTION

,

TEXTAREA

,

OBJECT

, and

IMG

tags.

Dreamweaver returns correct references for Netscape Navigator for

A

,

AREA

,

APPLET

,

EMBED

,

LAYER

,

ILAYER

,

SELECT

,

OPTION

,

TEXTAREA

,

OBJECT

, and

IMG

tags, and for absolutely positioned

DIV

and

SPAN

tags. For

DIV

and

SPAN

tags that are not absolutely positioned, Dreamweaver returns

"cannot reference <tag>"

.