Next: Make a Viewport
Up: Viewport Manipulation Subprograms
Previous: Define Scroll 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:
- The specified Viewport must have been previously defined via a call to
UI_DEFINE_VIEWPORT.
- Whether the Text or Graphics Viewport corresponding to the specified
Viewport ID is resized depends on the currently setup Viewport Mode.
- The Coordinates should be specified in the appropriate units for the
currently setup Viewport Mode.
- 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.
- 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