Museum

 XmTextFieldReplace(Xm)         6 January 1993         XmTextFieldReplace(Xm)


 Name

    XmTextFieldReplace - a TextField function that replaces part of a text
    string

 Syntax


    #include <Xm/TextF.h>

    void XmTextFieldReplace (widget, from_pos, to_pos, value)
    Widget widget;
    XmTextPosition from_pos;
    XmTextPosition to_pos;
    char * value;


 Description

    XmTextFieldReplace replaces part of the text string in the TextField
    widget. The character positions begin at zero and are numbered sequen-
    tially 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 TextField 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 TextField and its associated resources, see
    XmTextField(Xm).

 See also

    XmTextField(Xm) and XmTextFieldReplaceWcs(Xm).