Difference between revisions of "MENU FILES"
Yvonnemilne (Talk | contribs) |
Helengeorge (Talk | contribs) (→Class) |
||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
Revision as of 15:41, 23 October 2009
Contents
Purpose
Display a menu of files for selection
Syntax
MENU FILES LIKE <skeleton>
[AT <expN1>,<expN2> TO <expN3>,<expN4>]
[BOLD]
[CLEAR]
[COMMAND <expC1>]
[INDEX]
[LABEL <expC2>]
[OFF]
[POPUP]
[QUIT]
[SELECT <expC3>]
[TRIM]
See Also
@...MENU, MENU, MENU AT, MENU COMMAND, MENU FIELDS, MENU FORMAT, MENU FRAME, MENU QUERY, MENU SCOPE, MENU(), MENUITEM()
Description
The MENU FILES command displays a menu of file names that match the specified <skeleton> pattern.
AT <expN1>,<expN2> TO <expN3>,<expN4>
The menu may be optionally positioned with the AT row <expN1>, column <expN2> and TO row <expN4> clauses, otherwise the menu is centered on the screen.
| Keyword | Description |
|---|---|
| BOLD | The menu frame is highlighted. |
| CLEAR | The inside of the menu frame is cleared before displaying the menu. |
| COMMAND <expC1> | The command <expC1> and all selections made from the menu are displayed in the action line (line 22). |
| INDEX | Only index files that match the active table are displayed in the menu. As the user scrolls through the menu items the corresponding index expression for the index file is displayed in the message line. |
| 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. |
| QUIT | When the QUIT option is specified, the [ABANDON] key exits the menu. |
| SELECT <expC3> | Multiple selections can be made. The MENUITEM() function can be used to return a string containing the selections made, each separated with <expC3>. Selections are made by placing the cursor on the required menu item and pressing the [RETURN] key. Once all the required selections have been made, the [EXIT/SAVE] key is used to save them or the [ABANDON] key will cancel them. The ASTORE() function can be used to place all the selections into separate array items. |
| TRIM | File extensions are not displayed in the menu. |
A file can be selected by entering the first character of its name. The following keys are also active in MENU FILES:
| Key | Action |
|---|---|
| [PAGE DOWN] | Display the next page of files |
| [PAGE UP] | Display the previous page of files |
| [CURSOR UP] | Skip to previous file |
| [CURSOR DOWN] | Skip to next file |
| [RETURN] | Select a file |
| [ABANDON] | Discard selected files and exit |
| [EXIT/SAVE] | Exit with selected files |
On exit from MENU FILES the MENUITEM() function will return the file list as a character string. If the [ABANDON] key was pressed, or no files were selected, then MENUITEM() will return a null string and MENU() will return –1.
Example
menu files like *.frm at 2,0 to 10,18; label "Reports" store menuitem() to rpt report form &rpt to print
Products
Recital Terminal Developer
