dialogTop property

[This documentation is preliminary and is subject to change.]

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

This property is not supported for Metro style apps using JavaScript.


HRESULT value = object.put_dialogTop(VARIANT v);HRESULT value = object.get_dialogTop(VARIANT* p);

Property values


the top coordinate of the dialog window.


The IHTMLDialog::dialogTop property applies only to windows that are created by using the IHTMLWindow2::showModalDialog method and the IHTMLWindow3::showModelessDialog method.

When a script calls the IHTMLWindow2::showModalDialog method, it suspends execution until the modal dialog box is closed. As a result, the script cannot use the IHTMLDialog::dialogTop 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.

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



Build date: 6/12/2012

Community Additions