'\" t
...\" TxtFieAR.sgm /main/8 1996/09/08 21:14:21 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmTextFieldInsert" "library call"
.SH "NAME"
\fBXmTextFieldInsert\fP \(em A TextField function that inserts a character string into a text string
.iX "XmTextFieldInsert"
.iX "TextField functions" "XmTextFieldInsert"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/TextF\&.h>
\fBvoid \fBXmTextFieldInsert\fP\fR(
\fBWidget \fBwidget\fR\fR,
\fBXmTextPosition \fBposition\fR\fR,
\fBchar \fB* value\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmTextFieldInsert\fP inserts a character string into the text string in
the TextField widget\&. The character positions begin at 0 (zero)
and are numbered
sequentially from the beginning of the text\&. For example, to insert a
string after the fourth character,
the \fIposition\fP parameter must be 4\&.
.PP
This routine calls the widget\&'s \fBXmNvalueChangedCallback\fP and
verification callbacks, either \fBXmNmodifyVerifyCallback\fP or
\fBXmNmodifyVerifyCallbackWcs\fP, or both\&. If both verification
callback lists are registered, the procedures of the
\fBXmNmodifyVerifyCallback\fP list are executed first and the resulting
data is passed to the \fBXmNmodifyVerifyCallbackWcs\fP callbacks\&.
If the \fBXmNcursorPosition\fP resource is greater than or is the same value as
\fIposition\fP, the \fBXmNmotionVerifyCallback\fP is called\&.
.IP "\fIwidget\fP" 10
Specifies the TextField widget ID
.IP "\fIposition\fP" 10
Specifies the position in the text string where the character string is
to be inserted
.IP "\fIvalue\fP" 10
Specifies the character string value to be added to the text widget
.PP
For a complete definition of TextField and its associated resources, see
\fBXmTextField\fP(3)\&.
.SH "RELATED"
.PP
\fBXmTextField\fP(3) and \fBXmTextFieldInsertWcs\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:34