Disable a Menu Button Response Text

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

Short Name Calling Sequence

STATUS = UIDIRE(BUTTID)

Long Name Calling Sequence

STATUS = UI_DISABLE_RESPONSE(...)

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. This Subprogram only has relevance for Action Menus where it turns the specified Button into a Comment Button.
3. 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.
4. Buttons are enabled by default.