next up previous contents
Next: Modify Menu Button Up: Retained Menu Definition Previous: Disable a Menu

Enable a Menu Button Response Text

This Subroutine enables a Menu Button that was previously disabled via a call to UI_DISABLE_RESPONSE.

Short Name Calling Sequence

STATUS = UIENRE(BUTTID)

Long Name Calling Sequence

STATUS = UI_ENABLE_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 converts the specified Button from being a Comment Button for an Action Menu into a Response Button provided that the Button already has some Response Text associated with it.
  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.


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