Difference between revisions of "MENU FORMAT"

From Recital Documentation Wiki
Jump to: navigation, search
(Example)
 
(4 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==Class==
 
Menus
 
 
 
 
==Purpose==
 
==Purpose==
 
Activate a menu format procedure
 
Activate a menu format procedure
Line 26: Line 22:
  
 
==See Also==
 
==See Also==
[[@...MENU]], [[MENU]], [[MENU AT]], [[MENU COMMAND]], [[MENU FIELDS]], [[MENU FILES]], [[MENU FRAME]], [[MENU QUERY]], [[MENU SCOPE]], [[MENU()]], [[MENUITEM()]]
+
[[@...MENU]], [[CERROR()]], [[MENU]], [[MENU AT]], [[MENU COMMAND]], [[MENU FIELDS]], [[MENU FILES]], [[MENU FRAME]], [[MENU QUERY]], [[MENU SCOPE]], [[MENU()]], [[MENUITEM()]]
  
  
Line 54: Line 50:
  
 
==Example==
 
==Example==
 +
<code lang="recital">
 
procedure main
 
procedure main
 
   clear
 
   clear
Line 61: Line 58:
 
   @0,5 menu "Browse";
 
   @0,5 menu "Browse";
 
     command "browse";
 
     command "browse";
     help "Browse the table.
+
     help "Browse the table."
 
return
 
return
 
menu format main
 
menu format main
 
</code>
 
</code>
 
  
 
==Products==
 
==Products==
Recital Mirage Server, Recital Terminal Developer
+
Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 
[[Category:Menus]]
 
[[Category:Menus]]
 
[[Category:Menus Commands]]
 
[[Category:Menus Commands]]

Latest revision as of 10:54, 30 August 2018

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