Syntax of the MENU instruction

The MENU instruction defines a set of options the end user can select to trigger actions in a program.

Syntax

MENU [title]
   [ ATTRIBUTES ( menu-attribute [,...] ) ]
   [ BEFORE MENU
       menu-statement
     [...]
   ]
   menu-option
   [...]
END MENU

where menu-option is one of:

{ COMMAND option-name
      [option-comment] [ HELP help-number ]
    menu-statement
    [...]
| COMMAND KEY ( key-name ) option-name
      [option-comment] [ HELP help-number ]
    menu-statement
    [...]
| COMMAND KEY ( key-name )
    menu-statement
    [...]
| ON ACTION action-name
             [ ATTRIBUTES ( action-attributes-menu ) ]
    menu-statement
    [...]
| ON IDLE seconds 
    menu-statement
    [...]
| ON TIMER seconds
    menu-statement
    [...]
}

where action-attributes-menu is:

{ TEXT = string
| COMMENT = string
| IMAGE = string
| ACCELERATOR = string
| DEFAULTVIEW = { YES | NO | AUTO }
| CONTEXTMENU = { YES | NO | AUTO }
| DISCLOSUREINDICATOR
    [,...] }

where menu-statement is:

{ statement
|  CONTINUE MENU
|  EXIT MENU
|  NEXT OPTION option 
|  SHOW OPTION { ALL | option [,...] } 
|  HIDE OPTION { ALL | option [,...] } 
}

where menu-attribute is:

{ STYLE = { "default" | "popup" | "dialog" }
| COMMENT = "string"
| IMAGE = "string"
}

title is a string expression defining the title of the menu.
menu-attribute is an attribute that defines the behavior and presentation of the menu.
key-name is an hot-key identifier (like F11 or Control-z).
option-name is a string expression defining the label of the menu option and identifying the action that can be executed by the user.
option-comment is a string expression containing a description for the menu option, displayed when option-name is the current.
help-number is an integer that allows you to associate a help message number with the menu option.
action-name identifies an action that can be executed by the user.
seconds is an integer literal or variable that defines a number of seconds.
action-name identifies an action that can be executed by the user.
action-attributes are dialog-specific action attributes.