XmTextFieldInsert(library call)             XmTextFieldInsert(library call)




 NAME    [Toc]    [Back]
      XmTextFieldInsert - A TextField function that inserts a character
      string into a text string

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

 DESCRIPTION    [Toc]    [Back]
      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    [Toc]    [Back]
      XmTextField(3) and XmTextFieldInsertWcs(3).


                                    - 1 -       Formatted:  January 24, 2005