PEXOCCLabel - Structure Label (5.0)

Synopsis 

 
   void PEXOCCLabel(
        PEXOCC context,
        long label
   )
 


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

Arguments

context
An OC context returned by a successful PEXCreateOCC call.

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

resource_id (OCC)
The resource identifier of the renderer or structure.

req_type (OCC)
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

label
A value to be used as a label.

Returns

None.

Description

Invoke PEXOCCLabel to create a label output command which has no visible effect.

The primary use for this function occurs when you store a label in a structure. You can use labels in various element pointer positioning operations. Labels you specify 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

See Structure Control and Miscellaneous Functions for an overview.