Sets or gets the height of the modal dialog window.
Syntax
[ sHeight = ] window.dialogHeight
Possible Values
sHeight | Variant that
specifies or receives the height of the dialog window. |
The property is read/write.
The property has no default value.
Remarks
The dialogHeight property applies only to windows that are created by using the showModalDialog method and the showModelessDialog method.
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
, or pc
), or a relative units designator (em
, ex
, or px
). For consistent results, specify the dialogHeight
and dialogWidth
in pixels when you design 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.
In Windows Internet Explorer 7, the dialogHeight property returns the height of the content area and no longer includes the height of the frame.
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