.BG
.FN blitmenu
.TL
blitmenu: Activate Pop-Up Menus
.CS
blitmenu(items, actions, force, return, number, setup, button)
.PP
.AG items
character vector giving the list of choices on the menu.
.AG actions
optional character vector of the same length as
`items' giving expressions to be executed
if the corresponding item is chosen.
.AG force
logical, should user be forced to make a choice of one of the menu items.
Default TRUE.
.AG return
logical, after completing the actions associated with `menu',
should execution return to the context it was in prior to executing `menu'.
Default TRUE.
Using `return=FALSE' is recommended
if `menu' is the last action of a macro or source file, since it
prevents a (growing) stack of source files, which may eventually use
up all available file descriptors.
.AG number
integer, number under which the menu should be stored inside the blit.
Using this number and `setup', menus can be repeatedly used without
retransmitting them.
The value of `number' should be between 1 and 8 (default 1).
.AG setup
logical, if TRUE, `blitmenu' does not attempt to actually perform
menu operations, but simply downloads the `items' into the blit.
Default FALSE.
.AG button
integer, mouse button number used to activate the menu.
Default 3.
.RT
If `action' is not supplied by the user, `menu' returns the integer
corresponding to the item the user selected.
If `force' is FALSE and the user makes an invalid selection, 0 is returned.
.PP
This function currently only works on Teletype 5620 terminals.
This function is experimental and may change or be deleted.
.EX
items <- c("List Datasets in Work Directory",
   "List Datasets in Save Directory",
   "quit")
actions <- c("ls( )","ls(pos=2)","q")
blitmenu(items,actions)

blitmenu(ls( ),encode("rm",ls( )),
   prompt="Which dataset should be removed?")
.KW plot*
.KW iplot*
.KW macros
.KW session
.WR
