dialogHeight property

Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.
2 out of 3 rated this helpful - Rate this topic

Sets or gets the height of the modal dialog window.

Syntax

JavaScript

p = object.dialogHeight

Property values

Type: Variant

the height of the dialog window.

Remarks

The dialogHeight property applies only to windows that are created by using the showModalDialog method and the showModelessDialog method.

When a script calls the showModalDialog method, it suspends execution until the modal dialog box is closed. As a result, the script cannot use the dialogHeight property to change the appearance of the modal dialog box. To control the appearance of the modal dialog box, use script in the file loaded by the sURL parameter or use the value of the sFeatures parameter to specify the desired settings.

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.

The default unit of measure for dialogHeight and dialogWidth in Microsoft Internet Explorer 4.0 is the em; in Microsoft 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.

Examples

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

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/dialogHeight.htm


<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>

See also

window

 

 

Send comments about this topic to Microsoft

Build date: 11/27/2012

Did you find this helpful?
(1500 characters remaining)

Community Additions

© 2013 Microsoft. All rights reserved.