IHTMLDialog

IHTMLDialog


This interface provides access to information about an HTML dialog box.

The dialog object is the special window object created by the IHTMLWindow2::showModalDialog method. From within the dialog window, scripts reference the dialog object as the top-level window property. There is no such dialog property in the dialog.

IHTMLDialog Methods
put_dialogTop   get_dialogTop   put_dialogLeft
get_dialogLeft   put_dialogWidth   get_dialogWidth
put_dialogHeight   get_dialogHeight   get_dialogArguments
put_returnValue   get_returnValue   close
toString

IHTMLDialog::put_dialogTop

HRESULT put_dialogTop(
    VARIANT v
);

Sets the top coordinate of the dialog box.

v
VARIANT structure containing either a string or value specifying the top coordinate.

This property applies only to windows created using the showModalDialog method.

See also get_dialogTop

IHTMLDialog::get_dialogTop

HRESULT get_dialogTop(
    VARIANT *p
);

Retrieves the top coordinate of the dialog box.

p
Address of a VARIANT structure that receives the top coordinate.

This property applies only to windows created using the showModalDialog method.

See also put_dialogTop

IHTMLDialog::put_dialogLeft

HRESULT put_dialogLeft(
    VARIANT v
);

Sets the left coordinate of the dialog box.

v
VARIANT structure containing a string or value specifying the left coordinate.

This property applies only to windows created using the showModalDialog method.

See also get_dialogLeft

IHTMLDialog::get_dialogLeft

HRESULT get_dialogLeft(
    VARIANT *p
);

Retrieves the left coordinate of the dialog box.

p
Address of a VARIANT structure that receives the left coordinate.

This property applies only to windows created using the showModalDialog method.

See also put_dialogLeft

IHTMLDialog::put_dialogWidth

HRESULT put_dialogWidth(
    VARIANT v
);

Sets the width of the dialog box.

v
VARIANT structure that contains a string or value specifying the width.

This property applies only to windows created using the showModalDialog method.

See also get_dialogWidth

IHTMLDialog::get_dialogWidth

HRESULT get_dialogWidth(
    VARIANT *p
);

Retrieves the width of the dialog box.

p
Address of a VARIANT structure that receives the width.

This property applies only to windows created using the showModalDialog method.

See also put_dialogWidth

IHTMLDialog::put_dialogHeight

HRESULT put_dialogHeight(
    VARIANT v
);

Sets the height of the dialog box.

v
VARIANT structure that contains a string or value specifying the height.

This property applies only to windows created using the showModalDialog method.

See also get_dialogHeight

IHTMLDialog::get_dialogHeight

HRESULT get_dialogHeight(
    VARIANT *p
);

Retrieves the height of the dialog box.

p
Address of a VARIANT structure that receives the height.

This property applies only to windows created using the showModalDialog method.

See also put_dialogHeight

IHTMLDialog::get_dialogArguments

HRESULT get_dialogArguments(
    VARIANT *p
);

Retrieves the variable or array of variables passed into the modal dialog window.

p
Address of a VARIANT structure that receives the variables.

This property applies only to windows created using the showModalDialog method.

IHTMLDialog::put_returnValue

HRESULT put_returnValue(
    VARIANT v
);

Sets the return value of the dialog box.

v
VARIANT structure that contains a string or value specifying the return value, which can be either TRUE or FALSE.

For event handler functions, the value of this property takes precedence over values returned by the function, such as through a return statement.

See also get_returnValue

IHTMLDialog::get_returnValue

HRESULT get_returnValue(
    VARIANT *p
);

Retrieves the return value of the dialog box.

p
Address of a VARIANT structure that receives the return value, which can be either TRUE or FALSE.

For event handler functions, the value of this property takes precedence over values returned by the function, such as through a return statement.

See also put_returnValue

IHTMLDialog::close

HRESULT close(void);

Closes the dialog box.

IHTMLDialog::toString

HRESULT toString(
    BSTR *String
);

Retrieves a string representation of the dialog object.

String
Address of a string variable that receives the string representation.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.