XmTextFieldInsert(3X)

     NAME
          XmTextFieldInsert - A TextField function that inserts a
          character string into a text string

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

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmTextFieldInsert 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 position parameter 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.

          widget    Specifies the TextField 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 TextField and its associated
          resources, see XmTextField(3).

     RELATED
          XmTextField(3) and XmTextFieldInsertWcs(3).