MENU FORMAT

From Recital Documentation Wiki
Jump to: navigation, search

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, CERROR(), 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

Products

Recital