KEYWORD SUBSTATEMENT IN MENU LAYOUTS

KEYWORD specifies the item's keyword.  It must follow an ITEM statement.  The keyword text is displayed on the screen.  When an item is selected, the system field @MENU_KEYWORD contains the keyword text.  The value of @MENU_KEYWORD can be examined to determine which item has been selected.  The menu LAYOUT SCREEN permits the statement "KEYWORD" to be abbreviated to "KEY".

SYNTAX

/[KEYWORD row column rendition text]

row

is an integer constant that specifies the row position where the keyword begins in the menu.

column

is an integer constant that specifies the column position where the keyword begins in the menu.

rendition

specifies the video attributes for the keyword.  More than one video attribute may be specified by separating the attributes with plus signs.

 

The valid video attributes are:

  • @NORMAL specifies normal video attribute.  [default setting]
  • @BLINK specifies blinking video attribute.
  • @BOLD specifies bold face video attribute.
  • @REVERSE specifies reverse video attribute.
  • @UNDERLINE specifies underlining video attribute.

text

specifies the keyword text.  This must be a quoted string with a maximum keyword text length of 39 characters.  The keyword text cannot be empty.  If this field is left empty, the entire KEYWORD statement will be ignored.

EXAMPLE

/KEYWORD 2 3 @REVERSE"ADD"

This example shows a keyword ADD which appears at row 2 and column 3 in the menu.  The video attribute is reverse video.  When this item is selected, @MENU_KEYWORD contains the text ADD.

NOTE:  If the KEYWORD substatement is not specified in the LAYOUT segment, then each item's sequence number (followed by a period '.') will be displayed in the menu.  The item number corresponds to the value returned in @MENU_CHOICE.  This feature is useful for applications where a user selects a menu item by entering the number of the desired item.

Item Statement in Menu Layouts    Perform Substatement in Menu Layouts