Macromedia dreamweaver 8-extending dreamweaver User Manual

The Objects API

165

windowDimensions()

Description

This function sets specific dimensions for the Options dialog box. If this function is not 
defined, the window dimensions are computed automatically.

Arguments

■

The value of the 

 argument is either 

"macintosh"

 or 

"windows"

, depending on 

the user’s platform.

Returns

Dreamweaver expects a string of the form 

"widthInPixels,heightInPixels"

.

The returned dimensions are smaller than the size of the entire dialog box because they do not 
include the area for the OK and Cancel buttons. If the returned dimensions do not 
accommodate all options, scroll bars appear.

Example

The following example of the 

windowDimensions()

 function sets the dimensions of the 

Parameters dialog box to 648 x 520 pixels for Windows and 660 x 580 pixels for the 
Macintosh:

function windowDimensions(platform){

var retval = ""
if (platform = = "windows"){
retval = "648, 520";
}else{
retval = "660, 580";
}
return retval;

}

NO

TE

Do not define this function unless you want an Options dialog box that is larger than 
640 x 480 pixels.