next up previous contents
Next: Modify Menu Text Up: Retained Menu Definition Previous: Enable a Menu

Modify Menu Button Text Style

This Subroutine allows the Text Style associated with a previously defined Menu Button on the currently setup Menu to be modified.

Short Name Calling Sequence

STATUS = UISTBU(BUTTID,STYLE)

Long Name Calling Sequence

STATUS = UI_STYLE_BUTTON(...)

Input Arguments

BUTTID (Integer) Button ID STYLE (Integer) Text Style

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_BUTTON ) Illegal Button ID 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. 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. The STYLE Argument overrides the default text style for the specified Menu Button. A Style of Zero is the normal (not bold, blinking, underlined etc.) and alternative styles may be specified by combining the following Style Masks (by ORing them together):-

    UISBLI                  ) Blinking
    UISTYLEBLINK            )
    
    UISBOL                  ) Bold
    UISTYLEBOLD             )
    
    UISREV                  ) Reverse Video
    UISTYLEREVERSE          )
    
    UISUND                  ) Underlined
    UISTYLEUNDERLINE        )
    

    These Parameters are defined in the Parameter Definition File described in Appendix B.3.



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