Specify Text Style for Viewport

This Subprogram may be used to specify the Style (Bold, Blinking, Reverse Video etc.) for Text within the currently setup Text Viewport.

Short Name Calling Sequence

STATUS = UISTVP(STYLE[,VPRTID])

Long Name Calling Sequence

STATUS = UI_STYLE_VIEWPORT(...)

Input Arguments

STYLE (Integer) Text Style VPRTID (Integer) Viewport ID (Optional)

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_VIEWPORT ) Illegal Viewport ID UIILVP )

Note:

1. This Subprogram only affects subsequent requests to display text within the currently setup Text Viewport (via UI_USE_VIEWPORT or UI_DEFINE_VIEWPORT).
2. The Style word contains several rendition bits that may be used to affect the display of text. A Style of Zero is the default (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.

3. For a Text Viewport to be made visible it must be displayed via a call to UI_DISPLAY_VIEWPORT. This may be performed either prior to, or following, this call.
4. The VPRTID Argument is optional and, if omitted, defaults to the currently setup Viewport.