Museum

 XmTextInsert(Xm)               6 January 1993               XmTextInsert(Xm)


 Name

    XmTextInsert - a Text function that inserts a character string into a
    text string

 Syntax


    #include <Xm/Text.h>

    void XmTextInsert(widget, position, value)
    Widget widget;
    XmTextPosition position;
    char * value;


 Description

    XmTextInsert inserts a character string into the text string in the Text
    widget. The character positions begin at zero and are numbered sequen-
    tially from the beginning of the text. For example, to insert a string
    after the fourth character, the parameter position 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.

    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 Text and its associated resources, see
    XmText(Xm).

 See also

    XmText(Xm) and XmTextInsertWcs(Xm).