Name

PEXSetEditingMode - Set Structure Editing Mode

Synopsis

void PEXSetEditingMode(Display ∗display, PEXStructure structure, int mode)

Arguments

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

structureThe resource identifier of the structure. 

modeThe editing mode (PEXStructureInsert or PEXStructureReplace).

Returns

None

Description

This function sets the editing mode for the structure specified.  The editing mode specifies how editing operations affect the structure.  If the editing mode is PEXStructureInsert, subsequent requests to create structure elements cause elements to be inserted into the structure. The element pointer is then incremented by the number of elements inserted.  If the editing mode is PEXStructureReplace, output requests that create structure elements cause structure elements to replace elements, starting at the location specified by the element pointer.

Data Structures

typedef XID             PEXStructure;

Errors

BadPEXStructure
The specified structure resource identifier is invalid.

BadValueThe specified value for mode is invalid. 

See Also

PEXCreateStructure