MENU SCOPE
Purpose
Display a popup menu for choosing record selection scope
Syntax
MENU SCOPE
[AT<expN1>,<expN2>]
[HELPFILE <.hlp filename> | (<expC1>)]
[LABEL <expC2>]
[OFF]
[POPUP]
See Also
@...MENU, MENU AT, MENU COMMAND, MENU FIELDS, MENU FILES, MENU FORMAT, MENU QUERY, SCOPE
Description
The MENU SCOPE command displays a menu containing possible record selection scopes.
| Scope | Description |
|---|---|
| Default scope of the operation, e.g. FOR is all, WHILE is rest. | |
| Next | Process next n records. Enter number of records to process, starting from current record. |
| All | Process all records. |
| Record | Process selected record. Enter the record number of the record to process. |
| Rest | Process all remaining records, starting from current record. |
| First | Process first n records. Enter number of records to process, starting from top of file. |
AT <expN1>,<expN2>
Position top left hand corner of menu at these row, column coordinates.
| Keyword | Description |
|---|---|
| HELPFILE <.hlp> | A helpful text file can be associated with the menu. The <.hlp filename> will be displayed in a read-only window for viewing when the [HELP] key is pressed. The window will be labeled "Operating instructions." The file name can be substituted with a <expC2>, enclosed in round brackets, which returns a valid filename. If no file extension is specified, then ".hlp" is assumed. The command, INSTRUCT, must be set ON when using this option. |
| LABEL <expC2> | The specified character string <expC2> is displayed at the top of the menu frame. |
| OFF | The display of messages in the message line is disabled. |
| POPUP | The screen is automatically saved when the menu is displayed, and restored when the menu is cleared. |
The following keys are active in the MENU SCOPE:
| Key | Action |
|---|---|
| [CURSOR UP] | Skip to previous menu item |
| [CURSOR DOWN] | Skip to next menu item |
| [RETURN] | Select a menu item |
| [ABANDON] | Abandon selection |
| [EXIT/SAVE] | Exit without selecting a scope |
You can select a menu item by entering its first character.
On exit from MENU SCOPE the MENUITEM() function will return the record selection scope. If the [ABANDON] key was pressed, or no scope was selected, then MENUITEM() will return an empty string "" and MENU() will return –1.
Example
menu scope at 2,0 store menuitem() to scope report form patrons &scope to print
Products
Recital
