graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPVP - Set View Priority

GPVP (wsid, view, refview, flag)

Purpose

Use GPVP to modify both the relative input and output priority of the given view in relation to another view on the specified workstation.

This subroutine sets the requested priority reference number and the requested relative priority to the specified values. When the application updates the workstation, the graPHIGS API sets the current priority reference number and current relative priority to the requested values.

This subroutine changes the output as well as the input priority of the specified view. This can produce visual changes on the display.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

view -- specified by user, fullword integer

View index (>=0)

refview -- specified by user, fullword integer

Priority reference view index (>=0)

flag -- specified by user, fullword integer

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

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
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
GPQRVO: Inquire Requested View Table Entries Output
GPVIP: Set View Input Priority
GPVOP: Set View Output Priority

RCP code

201330689 (X'0C001001')