showModalDialogshowModalDialog*
*



Contents  *



Index  *Topic Contents
*Previous Topic: showHelp
*Next Topic: start

showModalDialog

Description

Creates a dialog box and displays in it the HTML document given by URL. The dialog box is a special window that is modal, meaning it retains the input focus until the user closes it.

Syntax

variant = object.showModalDialog(sURL [, vArguments [, sFeatures]])

ParameterDescription
sURL String specifying the URL of the document to load and display. While an empty string is accepted (""), it should be noted that this is useless since once a modal dialog has been opened, it cannot be accessed by the page that opened it.
vArguments Optional. Variant specifying the arguments to use when displaying the document. This parameter can be used to pass a value of any type including an array of values. The dialog can extract the values passed by the caller from the dialogArguments property of the window object.
sFeatures Optional. String specifying the window ornaments for the dialog box. It can be a combination of the following values.
Syntax Description
dialogWidth:number Sets the width of the dialog window.
dialogHeight:number Sets the height of the dialog window.
dialogTop:number Sets the top position of the dialog window relative to the upper-left corner of the desktop.
dialogLeft:number Sets the left position of the dialog window relative to the upper-left corner of the desktop.
center:{yes | no | 1 | 0 } Specifies whether to center the dialog window within the desktop. Default is yes.

Return Value

Returns a number, string, or other value. This is equal to the value of the returnValue property as set by the document given by URL.

Remarks

The default font settings should be set in the same way CSS attributes are set; for example, "font:3;font-size:4". To define multiple font values, use multiple font attributes.

When dialogLeft and/or dialogTop is specified, the feature center is overridden, even though the default for center is yes.

Applies To

window


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.