FORMULA LANGUAGE


@DialogBox
Example

Brings up a dialog box that displays the current document (either open or selected in a view). The dialog box shares fields with the underlying document. The user interacts with the dialog box as usual, clicking OK or Cancel when finished.

This function can be used with any form, but it's particularly useful with forms that contain a single table or layout region, because the user can interact with the table or layout region as if it were a dialog box.

Syntax

@DialogBox( form ; [AUTOHORZFIT] : [AUTOVERTFIT] : [NOCANCEL] : [NONEWFIELDS] : [NOFIELDUPDATE] : [READONLY] : [SIZETOTABLE] : [NOOKCANCEL] : [OKCANCELATBOTTOM] : [NONOTE] ; title )

Parameters

form


[AUTOHORZFIT]
[AUTOVERTFIT]
[NOCANCEL]
[NONEWFIELDS]
[NOFIELDUPDATE]
[READONLY]
[SIZETOTABLE]

Note This parameter is new with Release 5.


[NOOKCANCEL]

Note This parameter is new with Release 5.


[OKCANCELATBOTTOM]

Note This parameter is new with Release 6.


[NONOTE]

Note This parameter is new with Release 7.


title
Return value

none


Usage

This function is useful in buttons for actions. It does not work in column or selection formulas, or in agents that run on a server (mail and scheduled agents). It is not intended for use in window title or form formulas. It can be used with any form, but it's particularly useful with forms that contain a single table or layout region, because the user can interact with the table or layout region as if it were a dialog box.

@DialogBox cannot return data from a rich text field.

You cannot use this function in Web applications.

If the form contains actions on the action bar, they are not displayed in the dialog box.

[AUTOHORZFIT] and [AUTOVERTFIT] allow you to display an entire layout region (no [SIZETOTABLE]) or table ([SIZETOTABLE]) in a dialog box without displaying the rest of the form. If the form has more than one layout region or table, the first is used. For best results:


If [AUTOHORZFIT] and [AUTOVERTFIT] are both omitted, the entire form is used and no sizing takes place. If the form contains no layout region (no [SIZETOTABLE]) or table ([SIZETOTABLE]), the entire form is used and no sizing takes place.

Sharing of field values

@DialogBox displays the current document using a different form. This means:


Language cross-reference

DialogBox method of LotusScript NotesUIWorkspace class

Example
See Also