next up previous contents
Next: Make a Viewport Up: Viewport Manipulation Subprograms Previous: Define Scroll Viewport

Resize a Viewport

This Subprogram resizes (but does not move) the specified Viewport on the Screen.

Short Name Calling Sequence

STATUS = UISZVP(VPRTID,XSIZE,YSIZE)

Long Name Calling Sequence

STATUS = UI_SIZE_VIEWPORT(...)

Input Arguments

VPRTID (Integer) Viewport ID XSIZE (Real) Viewport X Size YSIZE (Real) Viewport Y Size

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 resized 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.


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