MENU FILES

From Recital Documentation Wiki
Revision as of 16:21, 2 June 2009 by Yvonnemilne (Talk | contribs)

Jump to: navigation, search

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