dialogTop Property

Internet Development Index

Sets or retrieves the top coordinate of the modal dialog window.

Syntax

window.dialogTop [ = sTop ]

Possible Values

sTopVariant that specifies or receives the top coordinate of the dialog window (see Remarks for default unit of measure).

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

Remarks

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

The default unit of measure for dialogTop 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 dialogTop in pixels when designing modal dialog boxes.

Example

This example creates a dialog window using the dialogTop property to set the position relative to the top of the screen. Do not break the script code into two lines as in the fourth line of the example. This was done for readability only.

<SCRIPT>
function someMessage()
{
event.srcElement.blur();
window.showModalDialog("message.htm", "",
"dialogWidth:5cm; dialogHeight:10cm;
dialogTop:0cm; dialogLeft:0cm")
}
</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