XmTextReplace(3X)

NAME
     XmTextReplace --A Text function that replaces part of a text string

SYNOPSIS
     #include <Xm/Text.h>

     void XmTextReplace (widget, from_pos, to_pos, value)
          Widget      widget;
          XmTextPositionfrom_pos;
          XmTextPositionto_pos;
          char        * value;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmTextReplace  replaces  part  of  the text string in the Text widget.  The
     character positions begin at zero and are numbered  sequentially  from  the
     beginning of the text.

     An  example text replacement would be to replace the second and third char-
     acters in the text string.  To accomplish this, the parameter from_pos must
     be 1 and to_pos must be 3.  To insert a string after the fourth  character,
     both parameters, from_pos and to_pos, 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.

     widget Specifies the Text widget ID

     from_pos
            Specifies the start position of the text to be replaced

     to_pos Specifies the end position of the text to be replaced

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


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

RELATED INFORMATION
     XmText(3X) and XmTextReplaceWcs(3X).

                                                               XmTextReplace(3X)