Name

PEXLabel - Structure Label

Synopsis

void PEXLabel(Display ∗display, XID resource_id, PEXOCRequestType req_type, long label)

Arguments

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

resource_idThe resource identifier of the renderer or structure. 

req_typeThe request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

labelA value to be used as a label. 

Returns

None

Description

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. 

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

PEXDeleteToLabel, PEXDeleteBetweenLabels, PEXSetElementPtrAtLabel