dialogHeight

HTML (DHTML)

dialogHeight Property

Internet Development Index

Sets or retrieves the height of the modal dialog window.

Syntax

window.dialogHeight [ = sHeight ]

Possible Values

sHeightVariant that specifies or receives the height of the dialog window (see Remarks for default unit of measure).

The property is read/write. The property has no default value.

Remarks

The dialogHeight property applies only to windows created using the showModalDialog and showModelessDialog methods.

The default unit of measure for dialogHeight and dialogWidth in Microsoft® Internet Explorer 4.0 is the em; in Internet Explorer 5 it is the pixel. The value can be an integer or floating-point number, followed by an absolute units designator (cm, mm, in, pt, pc, or px) or a relative units designator (em or ex). For consistent results, specify the dialogHeight and dialogWidth in pixels when designing modal dialog boxes.

Although a user can manually adjust the height of a dialog box to a smaller value—provided the dialog box is resizable—the minimum dialogHeight you can set using script is 100 pixels.

Example

This example creates a dialog window using the dialogHeight property to set the new window's height.

<SCRIPT>
function someMessage()
{
event.srcElement.blur();
window.showModalDialog("message.htm", "",
"dialogWidth:5cm; dialogHeight:10cm")
}
</SCRIPT>
</HEAD>
<BODY>
<SELECT onchange="someMessage()">
<OPTION>Item 1</OPTION>
<OPTION>Item 2</OPTION>
<OPTION>Item 3</OPTION>
</SELECT>
This feature requires Microsoft® Internet Explorer 4.0 or later. Click the following icon to install the latest version. Then reload this page to view the sample.

Standards Information

There is no public standard that applies to this property.

Applies To

window