_msdrv.utl Utility - Menu System Driver Program

Syntax

call "_msdrv.utl",menu_file$,menu_key${,item,current_value,
control_value,menu_record,initialize_window,override,
column,row,columns,menu_style,item_description$,
option_flag{,items_displayed}}
call "_msdrv.utl",$$,$$,item,current_value,control_value,
menu_record,initialize_window,override,column,row,columns,
menu_style,item_description,option_flag{,items_displayed}

Description

The _msdrv.utl utility is the menu driver program. The two syntaxes work in different ways:

The first syntax model processes a menu entry stored in a menu file.
The second syntax model processes a menu entry created dynamically by the _msmktpl.utl or _mkdlog.utl programs.

Using the second method and _msmktpl.utl requires the calling application program to construct a secondary template for one of the fields contained within the main template returned by _msmktpl.utl. This secondary template is discussed in Detail Template in _msmktp.utl.

Parameter	Description
`menu_file$`	Name of the menu file. If no extension (.xxx) is specified, `_msedit.utl` looks for the file `menuname.m`(LANGUAGE).
`menuitem$`	Key within the menu file to create or edit.
`item`	Selected item (returned).
`current_value`	Initial (default value).
`control_value`	I/O Subsystem CTLVAL based on the keystroke entered (returned to the calling program).
`menu$`	Immediate-mode menu template (created by `_msmktpl.utl`) or full template created by `_mkdlog.utl`.
`initialize_window`	Menu display, as follows:
	0 Do not display the menu.
	1 Display the menu.
`override`	If this value is 0, ignore the next four fields.
`column`	Display at this column; ignored unless OVERRIDE=1.
`row`	Display starting on this row; ignored unless OVERRIDE=1.
`columns`	Override column width; ignored unless OVERRIDE=1.
`menu_style`	Menu style of cascading/sliding menu; ignored unless OVERRIDE=1.
`item_description$`	Returns the description of the selected item.
`option_flag$`	Additional values that are acceptable as selections.
`items_displayed`	Reserved for internal use only.

Example

LET BBEXT$=STBL("BBEXT")
LET menufile$="mainmenu.m"+STBL("LANGUAGE")
LET menuitem$="main"
CALL BBEXT$+"_msdrv.utl",MENUFILE$,MENUITEM$,
item,retval,ctlval,$$,1

_msdrv.utl Utility - Menu System Driver Program

Syntax

Description

Example

See Also