Ring menus (MENU) / Using ring menus |
A MENU statement is a controller for user actions, defining action handlers triggered by action views. Actions views in the form file (i.e. toolbar buttons, topmenu items or push buttons) are bound to menu options by name. For example, if a MENU instruction defines ON ACTION sendmail, a form BUTTON with the name "sendmail" will be attached to that action handler.
When binding action views to menu option clauses, the action name is case sensitive. The compiler converts COMMAND labels and ON ACTION identifiers to lowercase to create the action name. It is recommended that you use all lowercase letters when defining the action name for action views and menu options.
Menu options can also be defined with the COMMAND clause. Unlike ON ACTION, the COMMAND clause takes a string literal as argument, that defines both the action name and the default text to be displayed in the default action view. For example, COMMAND "Help" will define the action name help and the default button text "Help". Action views must be bound with the action name in lower case (help).
When the menu is rendered as a popup of dialog box, no explicit action views need to be defined, default action views will be created and will get the decoration specified in action defaults.