MENU AT

From Recital Documentation Wiki
Revision as of 15:43, 23 October 2009 by Helengeorge (Talk | contribs)

Jump to: navigation, search


Purpose

Display a framed menu then activate it


Syntax

MENU AT <expN1>,<expN2> TO <expN3>,<expN4> WITH <exp list>

[BOLD]

[CLEAR]

[COMMAND <expC2>]

[LABEL <expC3>]

[OFF]

[QUIT]

[SELECT <expC4>]


See Also

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


Description

The MENU AT command displays a static pop-up choice list made up of a series of characters separated by commas, "<expC>,<expC>" as defined by the WITH <exp list> clause. Each set of characters between the commas becomes a separate menu item. The MENU AT choice list is non-scrollable, and can take up to 19 item, framed with a box. The menu display is positioned with the AT row <expN1>, column <expN2> TO row <expN3>, column <expN4> coordinates.


Keyword Description
BOLD The menu frame is highlighted.
CLEAR The inside of the menu frame is cleared before displaying the menu.
COMMAND <expC2> The command <expC2> and all selections made from the menu are displayed in the action line (line 22).
LABEL <expC3> The specified character string <expC3> is displayed at the top of the menu frame.
OFF The display of messages in the message line is disabled.
QUIT When the QUIT option is specified, the [ABANDON] key exits the menu.
SELECT <expC4> Multiple selections can be made. The MENUITEM() function can be used to return a string containing the selections made, each separated with <expC4>. 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.


On completion of this command, the MENUITEM() function will return the menu option selected as a character string.


Example

menu at 10,10 to 15,18;
  label "Options";
  with "Exit","Browse"
if menuitem() = "Browse"
    browse
else
    return
endif


Products

Recital Mirage Server, Recital Terminal Developer