Move a Viewport

This Subprogram moves (but does not resize) the specified Viewport on the Screen.

Short Name Calling Sequence

STATUS = UIMVVP(VPRTID,XLOW,YLOW)

Long Name Calling Sequence

STATUS = UI_MOVE_VIEWPORT(...)

Input Arguments

VPRTID (Integer) Viewport ID XLOW (Real) Viewport Low X YLOW (Real) Viewport Low Y

Output Arguments

None

Function Value

UI__SUCCESS ) Success UISUCC )

UI__NOT_INITIALIZED ) Package not Initialized UININI )

UI__ILLEGAL_VIEWPORT ) Illegal Viewport ID UIILVP )

UI__ILLEGAL_LIMITS ) Illegal Viewport Limits UIILLI )

Note:

1. The specified Viewport must have been previously defined via a call to UI_DEFINE_VIEWPORT.
2. Whether the Text or Graphics Viewport corresponding to the specified Viewport ID is moved depends on the currently setup Viewport Mode.
3. The Coordinates should be specified in the appropriate units for the currently setup Viewport Mode.
4. This Subprogram does not affect the definition of the currently setup Viewport which remains as defined by the last call to UI_DEFINE_VIEWPORT or IU_USE_VIEWPORT.
5. The Viewport Mode is defaulted to Text on initialisation of UIPACK. It may be changed by calling UI_VIEWPORT_MODE and may be determined by calling UI_INQUIRE_VIEWPORT_MODE.