Disable a Menu Button

This Subroutine disables a Menu Button without destroying the Descriptive Text associated with the Button. The Button may later be re-enabled via a call to UI_ENABLE_BUTTON.

Short Name Calling Sequence

STATUS = UIDIBU(BUTTID)

Long Name Calling Sequence

STATUS = UI_DISABLE_BUTTON(...)

Input Arguments

BUTTID (Integer) Button ID

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_BUTTON ) Illegal Button ID UIILBU )

UI__ILLEGAL_MENU ) Illegal Menu UIILME ) 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. Button IDs range from 1-NBUTTS (as defined by UI_DEFINE_BUTTONS) for the currently setup Menu. A maximum of 256 buttons are allowed per menu.
3. Buttons are enabled by default.