Menu descriptors

``Frame descriptors for menu definition files'' lists the frame descriptors that can be used in a menu definition file. None of these descriptors is required in a menu definition file. If any are used they can be in any order, but they must precede the item descriptors.

Frame descriptors for menu definition files

Descriptor	Default if not defined	Type	When referenced	Default frequency of evaluation
altslks	FALSE	Boolean	When menu is opened/updated	When menu is opened/updated
autosort	FALSE	Boolean	When menu is opened/updated	When menu is opened/updated
begcol	any	position	When menu is opened/updated	When menu is opened/updated
begrow	any	position	When menu is opened/updated	When menu is opened/updated
close	no default	null	When menu is closed for any reason	When menu is closed for any reason
columns	calculated value**	integer	When menu is opened/updated	When menu is opened/updated
done	no default	command	When items are selected (not marked) in a multi-select menu; ignored in a single-select menu	Whenever referenced
framemsg	no default	string	When menu is opened/updated	When menu is opened/updated
help	no default	command	When user asks for help	Whenever referenced
init	TRUE	Boolean	When menu is opened/updated	When menu is opened/updated
interrupt	inherited value*	Boolean	When an interruptible descriptor is evaluated	Whenever referenced

Descriptor	Default if not defined	Type	When referenced	Default frequency of evaluation
lifetime	longterm	string	When menu is opened, closed, made current, or made non-current	Whenever referenced
oninterrupt	inherited value*	command	After descriptor evaluation is interrupted	Whenever referenced
menu	Menu	string	When menu is opened	When menu is opened
multiselect	FALSE	Boolean	When menu is opened/updated	When menu is opened/updated
reread	FALSE	Boolean	When a checkworld occurs	Whenever referenced
rows	calculated value**	integer	When menu is opened/updated	When menu is opened/updated

``Item descriptors for menu definition files'' lists the item descriptors that can be used in a menu definition file. In each set of item descriptors, name is required and must be the first descriptor.

Item descriptors for menu definition files

Descriptor	Default if not defined	Type	When referenced	Default frequency of evaluation
action	no default	command	When item is selected	Whenever referenced
description	no default	string	When menu is opened/updated	When menu is opened/updated
inactive	FALSE	Boolean	When menu is opened/updated	When menu is opened/updated
interrupt	inherited value*	Boolean	When action descriptor is evaluated	Whenever referenced
itemmsg	no default	string	When item is navigated to	Whenever referenced
lininfo	no default	string	When item is navigated to	Whenever referenced
name	no default	string	When menu is opened/updated	When menu is opened/updated
oninterrupt	inherited value*	command	After action descriptor evaluation is interrupted	Whenever referenced
selected	FALSE	Boolean	When menu is opened/updated	When menu is opened/updated
show	TRUE	Boolean	When menu is opened/updated	When menu is opened/updated

``SLK descriptors for menu definition files'' lists the descriptors that can be used to define screen-labeled function keys in a menu definition file. The name and button descriptors must be defined, and name must be first in each set of SLK descriptors.

SLK descriptors for menu definition files

Descriptor	Default if not defined	Type	When referenced	Default frequency of evaluation
action	no default	command	When SLK is pressed	Whenever referenced
button	no default	integer	When menu is opened/updated	Whenever referenced
interrupt	inherited value*	Boolean	When SLK action descriptor is evaluated	Whenever referenced
name	no default	string	When menu is opened/updated	Whenever referenced
oninterrupt	inherited value*	command	After SLK action descriptor evaluation is interrupted	Whenever referenced

*

The value of interrupt and oninterrupt in any given set of descriptors is inherited from the next higher level in a precedence hierarchy. If these descriptors have not been defined anywhere in your application, interrupt defaults to FALSE and oninterrupt defaults to `message Operation interrupted!`nop. (See ``Interrupt signal handling'' for more information.)

**

The default value for columns and rows is determined by FMLI and depends in part on the number of items defined in the menu. (See ``Programming tips and known problems'', for a table describing the method of calculation.)