INQUIRE LIST OF STRUCTURES POSTED TO VIEW

PXINQ_LIST_STRUCTS_POSTED_VIEW

CALLING SEQUENCE

pxinq_list_structs_posted_view (

Pint	ws_id	/*workstation identifier	*/
Pint	index	/*view index	*/
Pint	length	/*length of each application list	*/
Pint	start	/*first entry to return	*/
Pint	*error_ind	/*error indicator	*/
Pint_list	*struct_ids	/*identifiers of structures	*/
Pfloat_list	*struct_prios	/*display priorities of structures	*/
Pint	*total_posted	/*total number of structures posted to the specified view	*/

)

EFFECT

GPHIGS maintains a list of the structures posted to a particular view, in the order in which they will be traversed, that is, in increasing order of display priority. This routine returns a segment of that list, starting at the specified position and containing the specified number of elements.

The application must provide storage for the list of structure identifiers and the list of structure display priorities that are returned by this routine. See the section "Memory Management for Inquiry Functions Which Return Simple Lists" in the introduction to Chapter 5 for additional information.

ERRORS

3

Ignoring function, function requires state WSOP.

54

Ignoring function, the specified workstation is not open.

59

Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO).

150

Ignoring function, setting this view table entry would exceed the maximum number of entries allowed in the workstation's view table.

114

Ignoring function, the view index value is less than zero.

2201

Ignoring function, the start index is out of range.

2202

Ignoring function, the length of the list is negative.

SEE ALSO

Post structure to view, see pxpost_struct_view

Unpost all structures, see punpost_all_structs

Unpost all structures from view, see pxunpost_all_structs_view

Unpost all structures from views, see pxunpost_all_structs_all_views, pxunpost_all_structs_list_views

Unpost structure, see punpost_struct

Unpost structure from view, see pxunpost_struct_view

Update view, see pxupd_ws_view

Update views, see pxupd_all_views, pxupd_list_views

Inquire list of views to which structure is posted, see pxinq_list_views_struct_posted