Lock Viewport

This Subprogram locks the currently setup Viewport such subsequent attempts to Drop the Viewport via calls to UI_DROP_VIEWPORT will be treated as illegal until the Viewport is unlocked by a call to UI_UNLOCK_VIEWPORT.

Short Name Calling Sequence

STATUS = UILKVP(PASSWD)

Long Name Calling Sequence

STATUS = UI_LOCK_VIEWPORT(...)

Input Arguments

PASSWD (Integer*4) Password

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_VIEWPORT ) Illegal Viewport UIILVP ) Note:

1. The currently setup Viewport will be locked until a later call to UI_UNLOCK_VIEWPORT with the same Password.
2. The Password must not be set to zero, or the request will be ignored.
3. Both the Text and Graphics Viewports are locked.
4. Viewports are unlocked by default.