Working with User Prompts

The following describes several functions that can be used to display information to the user. These functions will display a dialog box window. In some cases, information is static. In other cases, the user can interact with the dialog box, and data values are returned to the underlying form.


[Pages 111 - 112]

Function

Description

Example

@Dialogbox

Displays a user-defined dialog box. Results from the dialog box are subsequently returned to the underlying form.

@DialogBox (form; style: title)
 

formThe name of the form to display in a dialog box.

styleOptional keyword that indicates what the dialog box should look like. If multiple options are specified, a colon should separate them.

In the following example, a form called RepeatOptions is displayed.

@Dialog box
 ("RepeatOptions";
 [AUTOHORZFIT]:
 [AUTOVERTFIT];
 "Recurring calendar
 event");
 
 

[AUTOHORZFIT]Auto-set horizontal size.

[AUTOVERTFIT]Auto-set vertical size.

[NOCANCEL]Do not display Cancel button.

[NONEWFIELDS]Do not create new fields on underlying form if the field does not already exist.

[NOFIELDUPDATE]Do not update fields on underlying form.

[READONLY]Disable the ability to edit content in the dialog box.

[SIZETOTABLE]Auto-set size based on the table.

[NOOKCANCEL]Do not display the OK and Cancel buttons on the dialog box.

[OKCANCELATBOTTOM]Place the OK and Cancel buttons at the bottom of the form. If parameter is omitted, buttons will display on right side of window.

titleThe title of the dialog box window.

 

@Prompt

Displays a popup dialog box to the user. This function can be used to capture data values or to capture the Cancel). Syntax:

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

styleA keyword that indicates what the dialog box should look like. Valid keywords include the following:

[CHOOSEDATABASE]
[LOCALBROWSE]
[OK]
[OKCANCELCOMBO]
[OKCANCELEDIT]
[OKCANCELEDITCOMBO]
[OKCANCELLIST]
 

The following are several examples.

@Prompt ([OK]; "Warning";
 "You must specify a
 request date");
@Prompt ([YESNO];
 "Continue?"; "Do you
 want to save this
 form?");
@Prompt ([OKCANCELEDIT];
 "Input"; "What is your
 name?";);
FIELD filename:=
 @Prompt([LOCALBROWSE];
 "Select a file.";"");1
 
 
[OKCANCELLISTMULT]
[PASSWORD]
[YESNO]
[YESNOCANCEL]
 

NOSORTAn optional keyword. Values are sorted if this parameter is omitted.

titleThe title of the dialog box window.

promptThe text to be displayed within the dialog box.

defaultchoiceThe default button or choice in the dialog box.

filetypeThe type of files to be displayed. This parameter is only required for the [LOCALBROWSE] style.

 







Lotus Notes Developer's Toolbox(c) Tips for Rapid and Successful Deployment
Lotus Notes Developers Toolbox: Tips for Rapid and Successful Deployment
ISBN: 0132214482
EAN: 2147483647
Year: N/A
Pages: 293
Authors: Mark Elliott
Simiral book on Amazon

Flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net