PEXSetElementPtrAtLabel - Set Structure Element Pointer at Label (5.0)

Synopsis 

 
   void PEXSetElementPtrAtLabel(
        Display *display,
        PEXStructure structure,
        long label,
        long offset
   )

Arguments

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

structure
The resource identifier of the structure.

label
The value of the label.

offset
The offset from the label.

Returns

None.

Description

Invoke PEXSetElementPtrAtLabel to set the element pointer for the specified structure at a position denoted by the label.

A search is conducted for the next label element with the specified label, starting at the current element pointer position plus one and proceeding in the forward direction. The search is non-descending, that is, it does not include any structures referenced by structure. If label is found, then the element pointer for the structure is set to the location of the label plus offset, which may be negative, zero, or positive. If the computed position is less than zero, then the element pointer is set to 0. If the computed position is beyond that of the last element in the structure, then the element pointer is set to the position of the last element in the structure. If label is not found, then the structure's element pointer is left unchanged.

Errors

BadPEXLabel
The specified label does not exist.

BadPEXStructure
The specified structure resource identifier is invalid.

BadPEXStructurePermission
The structure's permission is PEXStructureLocked.

See Also

For a list of all Structure functions and related topics, see Structures.