Lotus Domino Designer 6.5 Help

FORMULA LANGUAGE

@Prompt
Example

Displays a dialog box to the user and returns a text value based on the user's actions in the dialog box. @Prompt is useful for prompting a user for information and determining a course of action based on the user's input.

Summary of Dialog Box Styles

This table shows the different styles of dialog boxes you can display. @Prompt accepts parameters and returns a value based on the style you indicate.

Style Purpose Contains Return value

CHOOSEDATABASE Displays a dialog box that allows the user to specify and open a database The title, "Choose Database;" List of choices for servers and databases; Open, Select, Cancel, Browse, Help, and About buttons Text. Three-value list. Server name, File name, Title of database. Returns null for Server name, if the database is local.

LOCALBROWSE Allows user to select a file name from the local file system Controls and displays for browsing local file system; Select, Cancel, and Network or Help buttons Text. File name that user selected or entered.

OK Displays an informational message Title and prompt; OK button 1 (True).

OKCANCELCOMBO Allows user to select one value from a drop-down list of choices Title and prompt; List of choices; OK and Cancel buttons Text. Value that user selected.

OKCANCELEDIT Allows user to type in text input Title and prompt; Text box for input; OK and Cancel buttons Text. Value that user entered.

OKCANCELEDITCOMBO Allows user to select one value from a list of choices, or type in a different value Title and prompt; List of choices with text box; OK and Cancel buttons Text. Value that user selected or entered.

OKCANCELLIST Allows user to select one value from a list of choices Title and prompt; List of choices; OK and Cancel buttons Text. Value that user selected.

OKCANCELLISTMULT Allows user to select multiple values from a list of choices Title and prompt; List of choices; OK and Cancel buttons Text list. All values that user selected, concatenated with a colon (:).

PASSWORD Allows user to enter password without displaying it on the screen Title and prompt; Text box that accepts and hides user input; OK and Cancel buttons Text. Password that user entered.

YESNO Allows user to make a Yes/No decision Title and prompt; Yes and No buttons 1 (True, Yes) or 0 (False, No).

YESNOCANCEL Allows user to make a Yes/No decision, or Cancel Title and prompt; Yes, No, and Cancel buttons 1 (True, Yes), 0 (False, No), or -1 (Cancel).

Syntax

@Prompt( [style] : [ NOSORT ] ; title ; prompt ; defaultChoice ; choiceList ; filetype )

Parameters

[style]

Keyword. Required. Indicates the type of dialog box to display. May be any of the following:

[CHOOSEDATABASE]

[LOCALBROWSE]

[OK]

[OKCANCELCOMBO]

[OKCANCELEDIT]

[OKCANCELEDITCOMBO]

[OKCANCELLIST]

[OKCANCELLISTMULT]

[PASSWORD]

[YESNO]

[YESNOCANCEL]

Include the square brackets ([ ]); these identify the style parameters as keywords. If no [NOSORT] keyword is provided, follow the style parameter with a semicolon (;).

[NOSORT]

Keyword. Optional. Include this keyword if you want the members of

choiceList

to appear in the exact order in which you enter them. If you omit this keyword, the members of

choiceList

are sorted alphabetically.

title

Text. The text you want displayed in the dialog box's title bar. Required for all

style

s, although you can specify a null string with "". The maximum number of characters you can include in a title is 65. Provide a null string with the [CHOOSEDATABASE] keyword; you cannot replace the default "Choose Database" title.

prompt

Text. The text you want displayed within the dialog box. Required for all

style

s, except LocalBrowse. If you use a formula for

prompt

and that formula returns a list, only the first item in the list is displayed as the

prompt

. To display the entire list, use @Implode. You can specify a field name to display the contents of the field as the

prompt

, but the field must be a text field. If it is a number or datetime field, precede it with @Text. @NewLine cannot be used in

prompt

. Use

@Char(13)

to insert a carriage return. The maximum number of characters you can include in the text that displays is 255. Provide a null string for the [CHOOSEDATABASE] keyword; you cannot display custom text in the Choose Database dialog box.

defaultChoice

Text. The value that will be used as the default value for the user's input. The input section of the dialog box is primed with the value; the user can either accept it by clicking OK or replace it with another value. Not applicable to dialog boxes of

style

[OK], [YESNO], [YESNOCANCEL], [LOCALBROWSE], or [PASSWORD]. Required for all other

style

s. For [OKCANCELLISTMULT], you can specify multiple default values as a text list "item1":"item2."

choiceList

Text list. The values that you want displayed in the dialog box's list box. The user can select one of these values as the input. Separate the values with colons, as in: "PHONE.NSF":@MailDbName. Each value in your list can be a text string, or an @function that returns a text string. Required only with

style

s [OKCANCELLIST], [OKCANCELCOMBO], [OKCANCELEDITCOMBO], and [OKCANCELLISTMULT].

filetype

Text. A value that specifies the types of files to display initially: "1" for NSF files only; "2" for NTF files only; "3" for files of all type. Required only with style [LOCALBROWSE].

Return value

choice

If the user enters a value, returns the value as text.
If the user selects Yes, returns 1 (True).
If the user selects No, returns 0 (False).
If the user selects Cancel, formula evaluation stops. The exception is [YESNOCANCEL], which returns -1 if the user selects Cancel.
@Prompt([OKCANCELEDIT]) returns only the first 254 characters of the text entered.

Usage

Use @Prompt in field formula, toolbar button, manual agent, form action, and view action formulas. This function does not work in column, selection, mail agent, or scheduled agent formulas, and has limited usefulness in window title and form formulas.

You cannot use this function in Web applications.

Language cross-reference

InputBox function of LotusScript language

DialogBoxCanceled property of LotusScript NotesUIDocument class

Prompt method of LotusScript NotesUIWorkspace class

Example
See Also

@DialogBox

Getting user input with @Prompt and @PickList

@PickList

Writing messages to the user

Examples: Lexical elements

Data types

Form fields

R5 Internet address manager code example from the Sandbox on the Lotus Developer Domain

"Adding a friendly ad-hoc query tool to Domino applications" on the Lotus Developer Domain

"Taking your Domino applications to the Web" on the Lotus Developer Domain

"Creating context-sensitive help for applications" on the Lotus Developer Domain

"The hidden power of Profile documents" on the Lotus Developer Domain

"Create your own formula debugger" on Tips from the Lotus Developer Domain

Glossary

Help on Help

Open Full Help Window

Glossary

Help on Help

Open Full Help Window

Style	Purpose	Contains	Return value
CHOOSEDATABASE	Displays a dialog box that allows the user to specify and open a database	The title, "Choose Database;" List of choices for servers and databases; Open, Select, Cancel, Browse, Help, and About buttons	Text. Three-value list. Server name, File name, Title of database. Returns null for Server name, if the database is local.
LOCALBROWSE	Allows user to select a file name from the local file system	Controls and displays for browsing local file system; Select, Cancel, and Network or Help buttons	Text. File name that user selected or entered.
OK	Displays an informational message	Title and prompt; OK button	1 (True).
OKCANCELCOMBO	Allows user to select one value from a drop-down list of choices	Title and prompt; List of choices; OK and Cancel buttons	Text. Value that user selected.
OKCANCELEDIT	Allows user to type in text input	Title and prompt; Text box for input; OK and Cancel buttons	Text. Value that user entered.
OKCANCELEDITCOMBO	Allows user to select one value from a list of choices, or type in a different value	Title and prompt; List of choices with text box; OK and Cancel buttons	Text. Value that user selected or entered.
OKCANCELLIST	Allows user to select one value from a list of choices	Title and prompt; List of choices; OK and Cancel buttons	Text. Value that user selected.
OKCANCELLISTMULT	Allows user to select multiple values from a list of choices	Title and prompt; List of choices; OK and Cancel buttons	Text list. All values that user selected, concatenated with a colon (:).
PASSWORD	Allows user to enter password without displaying it on the screen	Title and prompt; Text box that accepts and hides user input; OK and Cancel buttons	Text. Password that user entered.
YESNO	Allows user to make a Yes/No decision	Title and prompt; Yes and No buttons	1 (True, Yes) or 0 (False, No).
YESNOCANCEL	Allows user to make a Yes/No decision, or Cancel	Title and prompt; Yes, No, and Cancel buttons	1 (True, Yes), 0 (False, No), or -1 (Cancel).