NAME

       XmTextReplace  —  A  Text  function  that replaces part of a text string "XmTextReplace" "Text functions"
       "XmTextReplace"

SYNOPSIS

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

DESCRIPTION

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

       An  example  text  replacement would be to replace the second and third characters 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.   The  XmNmotionVerifyCallback  is  generated  if
       to_pos is less than or equal to the cursor position and the length of value is not the same as the length
       of the text being replaced, or if the cursor position is between from_pos and to_pos,  and  the  distance
       from the cursor position to from_pos is greater than the length of value.

       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 XmText(3).

RELATED

       XmText(3) and XmTextReplaceWcs(3).

                                                                                                XmTextReplace(3)