next up previous contents
Next: Define Viewport for Up: Retained Menu Definition Previous: Define a new

Use a Menu

This Subprogram may be used to define which already existing Menu is to be modified.

Short Name Calling Sequence

STATUS = UIUSME(MENUID[,OLDID])

Long Name Calling Sequence

STATUS = UI_USE_MENU(...)

Input Arguments

MENUID (Integer) Menu ID

Output Arguments

OLDID (Integer) Old Menu ID (Optional)

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_MENU ) Illegal Menu ID UIILME )

Note:

  1. Function Value UI__ILLEGAL_MENU will result if the MENUID Argument does not refer to an already existing Menu.
  2. The OLDID Argument is optional and, if present, will be set to the current Menu ID prior to this call. This will be negative if no Menu is setup as being current at the time of the call.


Liz Buckle
Fri Jan 13 17:39:04 CST 1995