READ MENU BAR

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Activate a FoxBASE+ style pull-down menu system


Syntax

READ MENU BAR TO <memvar1>,<memvar2>

[SAVE]

[TIMEOUT <expN>]


See Also

MENU, MENU BAR, READ MENU


Description

The READ MENU BAR command activates a pulldown menu system. The <memvar1> and <memvar2> variables are used to position the light bar menu on the required pulldown. On selection of a pulldown item, the variables return the item selected. The menu clears from the screen after a menu selection is made, unless the SAVE option is specified. The SAVE option causes the menu to remain on the screen after a menu selection is made.

As this is the last step in creating a pulldown menu system, menu arrays and menu bars must be initialized and installed prior to using the READ MENU BAR command.

SAVE

The menu options are not released and can be activated by another READ MENU BAR command.

TIMEOUT <expN>

The TIMEOUT clause determines how long in seconds, <expN>, the READ MENU BAR will wait for user input before exiting automatically.


Example

// Install the pull-down menu system
menu bar top,3
menu 1,files,7,7
menu 2,modify 5,5
menu 3,data,9,9
 
// Activate the pull-down menu system
row = 1
col = 1
read menu bar to row, col save


Products

Recital