Name

PEXSetElementPtr - Set Structure Element Pointer

Synopsis

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

Arguments

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

structureThe resource identifier of the structure. 

whenceA value specifying with offset, the element pointer position (PEXBeginning, PEXCurrent, PEXEnd).

offsetThe offset from whence which specifies the element pointer position. 

Returns

None

Description

This function sets the element pointer for the structure specified to the position specified. 

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

Data Structures

typedef XID             PEXStructure;

Errors

BadPEXStructure
The specified structure resource identifier is invalid.

BadValueThe specified value for whence parameter is invalid. 

See Also

PEXCreateStructure