.\" @(#)PEXSetEditingMode.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetEditingMode 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetEditingMode - Set Structure Editing Mode
.SH SYNTAX
.HP
void PEXSetEditingMode\^(\^Display *\fIdisplay\fP\^, PEXStructure \fIstructure\fP\^, int \fImode\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIstructure\fP 1i
The resource identifier of the structure.
.IP \fImode\fP 1i
The editing mode (
.B PEXStructureInsert
or
.B PEXStructureReplace
).
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetEditingMode
.LP
This function sets the editing
.I mode
for the structure
specified.  The editing
.I mode
specifies how editing operations
affect the structure.
If the editing
.I mode
is
.B 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
.I mode
is
.B PEXStructureReplace,
output requests that create structure elements cause
structure elements to replace elements, starting at the location
specified by the element pointer.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
.fi
.sp .5
.SH ERRORS
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.TP
.SB BadValue
The specified value for mode is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateStructure (3)
.fi