Define Menu Buttons

This Subroutine specifies the number of buttons on the currently setup Menu (via UI_DEFINE_MENU or UI_USE_MENU). The descriptive Text on each Button is specified.

Short Name Calling Sequence

STATUS = UIDFBU(BUTEXT,NBUTTS)

Long Name Calling Sequence

STATUS = UI_DEFINE_BUTTONS(...)

Input Arguments

BUTEXT (Character Array) Button Descriptive Text NBUTTS (Integer) No. of Buttons

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package Not Initialized UININI )

UI__ILLEGAL_MENU ) Illegal Menu ID UIILME )

UI__ILLEGAL_BUTTON ) Illegal No. of Buttons UIILBU ) Note:

1. This subroutine operates on the currently setup Menu as defined by a prior call to UI_DEFINE_MENU or UI_USE_MENU.
2. The BUTEXT Argument is a Character Array (having NBUTTS elements) that contains the descriptive text to be associated with each item on the Menu.
3. If the Descriptive Text corresponding to a particular Button is null (all spaces), then that Button is treated as a blank line and is skipped.
4. A maximum of 256 buttons may be associated with a Menu. Thus NBUTTS may lie in the range 1-256.