NAME

       XmTextInsert  —  A  Text  function  that  inserts  a  character  string into a text string
       "XmTextInsert" "Text functions" "XmTextInsert"

SYNOPSIS

       #include <Xm/Text.h>
       void XmTextInsert(
       Widget widget,
       XmTextPosition position,
       char * value);

DESCRIPTION

       XmTextInsert inserts a character string into the text  string  in  the  Text  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  parameter
       position must be 4.

       This routine calls the widget's XmNvalueChangedCallback and verification callbacks, either
       XmNmodifyVerifyCallback or  XmNmodifyVerifyCallbackWcs,  or  both.  If  both  verification
       callback  lists  are  registered,  the  procedures of the XmNmodifyVerifyCallback list are
       executed first  and  the  resulting  data  is  passed  to  the  XmNmodifyVerifyCallbackWcs
       callbacks.   If  the  XmNcursorPosition  resource  is greater than or is the same value as
       position, the XmNmotionVerifyCallback is called.

       Note that, if  value  is  a  null  string,  no  callbacks  will  be  generated,  since  no
       modifications will have been made.

       widget    Specifies the Text widget ID.

       position  Specifies  the  position  in the text string where the character string is to be
                 inserted.

       value     Specifies the character string value to be added to the text widget.

       For a complete definition of Text and its associated resources, see XmText(3).

RELATED

       XmText(3) and XmTextInsertWcs(3).

                                                                                  XmTextInsert(3)