Displays a dialog box and returns a value based on your actions in the dialog box.

Note This method is new with Release 5.

Defined in

NotesUIWorkspace

Syntax

variant = notesUIWorkspace.Prompt( type%, title$, prompt$ [, default ] [, values ] )

Parameters

type%

Constant. Indicates the type of dialog box that you want to display. May be any of the following:

PROMPT_CHOOSEDATABASE (13)

Note The constant name PROMPT_CHOOSEDATABASE is not implemented in Release 6.0 but the literal value 13 can be used instead.

PROMPT_OK (1)

PROMPT_OKCANCELCOMBO (5)

PROMPT_OKCANCELEDIT (3)

PROMPT_OKCANCELEDITCOMBO (6)

PROMPT_OKCANCELLIST (4)

PROMPT_OKCANCELLISTMULT (7)

PROMPT_PASSWORD (10)

PROMPT_YESNO (2)

PROMPT_YESNOCANCEL (11)

String. The text that you want displayed in the dialog box title bar. Required for all type%s, although you can specify a null string with "". The maximum number of characters is 65.

String. The text that you want displayed within the dialog box. Required for all type%s, although you can specify a null string with "". The maximum number of characters is 255.

The value that will be used as your default input value. The input section of the dialog box is primed with the value; you can accept it by selecting OK, replace it with another value, or Cancel.

Not applicable to dialog boxes of type% PROMPT_OK, PROMPT_YESNO, PROMPT_YESNOCANCEL, or PROMPT_PASSWORD Optional for all other type%s. However, for PROMPT_OKCANCELCOMBO and PROMPT_OKCANCELEDITCOMBO a default is recommended so that the input section is not blank.

The value listed as the default must be included in the values list; otherwise, it is ignored.

The default value(s) for PROMPT_OKCANCELEDIT, PROMPT_OKCANCELLIST, PROMPT_OKCANCELCOMBO, PROMPT_OKCANCELEDITCOMBO, and PROMPT_OKCANCELLISTMULT is a string, a string array, a variant of type string, or a variant array of strings.

The values that you want displayed in the dialog box list box. You can select one of these values as the input. Required only with type%s PROMPT_OKCANCELLIST, PROMPT_OKCANCELCOMBO, PROMPT_OKCANCELEDITCOMBO, and PROMPT_OKCANCELLISTMULT.

The values for PROMPT_OKCANCELLIST, PROMPT_OKCANCELCOMBO, PROMPT_OKCANCELEDITCOMBO, and PROMPT_OKCANCELLISTMULT are a string array, a variant of type string, or a variant array of strings.

	Variant of type integer	for PROMPT_OK, PROMPT_YESNO, PROMPT_YESNOCANCEL
	Variant of type string	for PROMPT_OKCANCELEDIT, PROMPT_OKCANCELLIST, PROMPT_OKCANCELCOMBO, PROMPT_OKCANCELEDITCOMBO, and PROMPT_PASSWORD
	Variant Array	for PROMPT_OKCANCELLISTMULT

Type% PROMPT_OK always returns 1. For type% PROMPT_YESNO, returns 1 if you select Yes. If you select No, returns 0. For type% PROMPT_YESNOCANCEL, returns 1 if you select Yes, 0 if you select No, and -1 if you select Cancel. For PROMPT_OKCANCELLISTMULT, the return value is a variant containing a string array if you select OK, and EMPTY if you select Cancel. For all other type%s the return value is a string if you press OK, and EMPTY if you press Cancel.

Language cross-reference

@Prompt function in formula language

Example

Glossary