.\" @(#)PEXPostStructure.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXPostStructure 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXPostStructure - Post Structure to a Workstation
.SH SYNTAX
.HP
void PEXPostStructure\^(\^Display *\fIdisplay\fP\^, PEXWorkstation \fIworkstation\fP\^, PEXStructure \fIstructure\fP\^, double \fIpriority\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIworkstation\fP 1i
The resource identifier of the workstation.
.IP \fIstructure\fP 1i
The resource identifier of the structure.
.IP \fIpriority\fP 1i
The priority of the newly-posted structure.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXPostStructure
.LP
This function adds the specified
.I structure
to the list of posted structures in the specified
.I workstation.
The
.I priority
is used to indicate the priority of the new posted structure
relative to the structures already posted.  If
multiple structures are posted for display to the same display space location,
the higher priority structure will be displayed.  If two structures have the
same priority, the last posted structure is considered of higher priority.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
typedef  XID	PEXWorkstation;
.fi
.SH ERRORS
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.TP
.SB BadPEXWorkstation
The specified workstation resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXUnpostStructure (3)
.BR PEXUnpostAllStructures (3)
.fi