next up previous contents
Next: Turn off Designation Up: Alert Viewport Subprograms Previous: Alert Viewport Subprograms

Designate Alert Viewport

This Subprogram designates the specified Viewport as an Alert Viewport. Subsequent requests to write to it (via UI_DISPLAY_LINE or UI_OUTPUT_TEXT) will cause it to be ``popped" to the front of the screen.

Short Name Calling Sequence

STATUS = UIALVP(VPRTID)

Long Name Calling Sequence

STATUS = UI_ALERT_VIEWPORT(...)

Input Arguments

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. The VPRTID Argument is optional and, if omitted, defaults to the currently setup Viewport.


Liz Buckle
Fri Jan 13 17:49:20 CST 1995