Museum

 XmTextReplace(Xm)              6 January 1993              XmTextReplace(Xm)


 Name

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

 Syntax


    #include <Xm/Text.h>

    void XmTextReplace (widget, from_pos, to_pos, value)
    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 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 frompos
    must be 1 and topos must be 3. To insert a string after the fourth char-
    acter, both parameters, frompos and topos, 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 pro-
    cedures of the XmNmodifyVerifyCallback list are executed first and the
    resulting data is passed to the XmNmodifyVerifyCallbackWcs callbacks.


    widget  Specifies the Text widget ID

    frompos
            Specifies the start position of the text to be replaced

    topos  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(Xm).

 See also

    XmText(Xm) and XmTextReplaceWcs(Xm).