dialogLeft property

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



p = object.dialogLeft


Property values

Type: Variant

the left coordinate of the dialog window.


The dialogLeft 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 dialogLeft 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 dialogLeft 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 dialogLeft in pixels when you design modal dialog boxes.


This example creates a dialog window that uses the dialogLeft property to set the position relative to the left side 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.

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

<!DOCTYPE html>

    The select box's <strong>onchange</strong> event will fire 
    off a script creating a modal dialog box located in the
    upper left corner of the screen (dialogTop: 0cm; dialogLeft: 0cm).
  <select onchange="someMessage()">
    <option>Item 1</option>
    <option>Item 2</option>
    <option>Item 3</option>
    function someMessage() {
      window.showModalDialog("dialogWidth.htm", "", "dialogWidth:5cm; dialogHeight:10cm; dialogTop:0cm; dialogLeft:0cm")

See also