MENU FILES

Class

Menus

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