.\" @(#)PEXLabel.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXLabel 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXLabel - Structure Label
.SH SYNTAX
.HP
void PEXLabel\^(\^Display *\fIdisplay\fP\^, XID \fIresource_id\fP\^, PEXOCRequestType \fIreq_type\fP\^, long \fIlabel\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIresource_id\fP 1i
The resource identifier of the renderer or structure.
.IP \fIreq_type\fP 1i
The request type for the output command (
.B PEXOCRender,
.B PEXOCStore,
.B PEXOCRenderSingle
or
.B PEXOCStoreSingle
).
.IP \fIlabel\fP 1i
A value to be used as a label.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXLabel
.LP
This function creates a
label output command which
has no visible effect.  Its primary function comes when it is stored in a
structure, as labels can be used in various element pointer positioning
operations.  Labels within a particular structure need not be unique.
.SH ERRORS
.TP
.SB BadPEXRenderer
The specified renderer resource identifier is invalid.
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXDeleteToLabel (3)
.BR PEXDeleteBetweenLabels (3)
.BR PEXSetElementPtrAtLabel (3)
.fi