PEXGetWorkstationViewRep - Get Workstation View Representation

Synopsis

 
   Status PEXGetWorkstationViewRep(
          Display *display,
          PEXWorkstation workstation,
          unsigned int index,
          int *update_return,
          PEXViewRep *req_view_return,
          PEXViewRep *cur_view_return
   )
 

Arguments

display

A pointer to a display structure returned by a successful XOpenDisplay call.

workstation

The resource identifier of the workstation.

index

The view table index.

update_return

Returns the update status of the view table index.

req_view_return

Returns the requested value of the view table index.

cur_view_return

Returns the current value of the view table index.

Returns

Zero if unsuccessful; non-zero otherwise.

Description

Invoke PEXGetWorkstationViewRep to get the update state (update_return), and the requested (req_view_return) and current values (cur_view_return) for the specified view index of the specified workstation.

The update is PEXPending if a view change has been requested but not established; otherwise the update is PEXNotPending. If the specified view index is not defined, then the implementationimplementation issues a BadValue error and the contents of the return arguments are undefined.

Errors

BadPEXWorkstation

The specified workstation resource identifier is invalid.

BadValue

The specified view table entry is not defined.

See Also

• PEXSetWorkstationViewRep

For a list of PHIGS Workstation functions and related topics, see PHIGS Workstation.