Modify Menu Button Response Command Text

This Subroutine allows the response Command Text associated with a previously defined Menu Button on the currently setup Menu to be modified. It is only useful for Action Menus.

Short Name Calling Sequence

STATUS = UIMORE(BUTTID,RETEXT)

Long Name Calling Sequence

STATUS = UI_MODIFY_RESPONSE(...)

Input Arguments

BUTTID (Integer) Button ID RETEXT (Character) Button Response Text

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_VERB ) Illegal Verb UIILVB ) 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 when the associated Menu is to be used as an Action Menu.
3. A Response Text String should commence either with a valid Verb for the Verb Group associated with the currently setup Menu, or with a Symbol (prefixed by an ``\&" character) that translates into a valid Verb, or with an Indirect Command File specification (prefixed with an ``@" character), where the first line of the Indirect File commences with a valid Verb.
4. 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.