graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPVIP - Set View Input Priority

GPVIP (wsid, view, refview, flag)

Purpose

Use GPVIP to modify the input priority of the given view in relation to another view on the specified workstation.

When the application updates the workstation, the current view input priority for the specified view is set to the requested values.

This subroutine only changes the input priority of a view. There are no visual changes on the display surface.

Note:

The Set View Priority (GPVP) subroutine is treated as a simultaneous invocation of the Set View Input Priority (GPVIP) and the Set View Output Priority (GPVOP) and subroutines.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

view -- specified by user, fullword integer

View index (>=0)

refview -- specified by user, fullword integer

Reference view index (>=0)

flag -- specified by user, fullword integer

Relative priority of the specified view with respect to the reference view (1=HIGHER, 2=LOWER )

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
38: WORKSTATION HAS ONLY OUTPUT CAPABILITIES
59: VIEW INDEX VALUE < ZERO
155: VIEW PRIORITY REFERENCE NUMBER IS INVALID
323: VIEW INDEX EXCEEDS VIEW TABLE CAPACITY
333: RELATIVE VIEW PRIORITY VALUE IS INVALID

Related Subroutines

GPQRVE: Inquire Requested View Table Entries Input
GPVOP: Set View Output Priority
GPVP: Set View Priority

RCP code

201330690 (X'0C001002')