PEXSetElementPtr - Set Structure Element Pointer (5.0)

Synopsis 

 
   void PEXSetElementPtr(
        Display *display,
        PEXStructure structure,
        int whence,
        long offset
   )

Arguments

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

structure
The resource identifier of the structure.

whence
A value specifying with offset, the element pointer position (PEXBeginning, PEXCurrent or PEXEnd).

offset
The offset from whence which specifies the element pointer position.

Returns

None.

Description

Invoke PEXSetElementPtr to set the element pointer for the specified structure to the specified position.

If the computed offset is less than zero, then it is set to zero. If the computed offset is greater than the number of elements in the structure, then it is set to the offset of the last element in the structure.

Errors

BadPEXStructure
The specified structure resource identifier is invalid.

BadPEXStructurePermission
The structure's permission is PEXStructureLocked.

BadValue
The specified value for whence argument is invalid.

See Also

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