MENU FORMAT

Class

Menus

Purpose

Activate a menu format procedure

Syntax

MENU FORMAT <procedure> | <program> | (<expC1>)

[EXIT]

[HELPFILE <.hlp filename> | (<expC2>)]

[NOREFRESH]

[OFF]

[QUIT]

[SAVE]

[SCREENMAP]

See Also

@...MENU, MENU, MENU AT, MENU COMMAND, MENU FIELDS, MENU FILES, MENU FRAME, MENU QUERY, MENU SCOPE, MENU(), MENUITEM()

Description

The MENU FORMAT command executes a procedure or program containing a menu definition. The MENU command provides full details of how menus are defined. The specified procedure should contain a series of commands that are used to build a menu. A MENU FORMAT procedure differs from a normal procedure in the following way: when a menu option is selected and its associated commands executed, the MENU FORMAT procedure is automatically re-executed. MENU FORMAT procedures may call other MENU FORMAT procedures from selected menu options, but not as a command when the MENU FORMAT is being processed.

Keyword	Description
EXIT	The menu is exited after the first selection rather than being reactivated and refreshed.
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.
NOREFRESH	The menu is generated without executing the extra commands (e.g. frame drawing) associated with it.
OFF	The display of messages in the message line is disabled.
QUIT	When the QUIT option is specified, the [ABANDON] key exits the menu.
SAVE	The menu options are not released and can be activated by another MENU command.
SCREENMAP	The screen is handled as if SCREENMAP is ON even when it is OFF.

Example

procedure main

 clear
 @0,0 menu "Exit";
   command "quit";
   help "Exit the system."
 @0,5 menu "Browse";
   command "browse";
   help "Browse the table.

return menu format main </code>

Products

Recital Mirage Server, Recital Terminal Developer