Museum

 XmTextSetSource(Xm)            6 January 1993            XmTextSetSource(Xm)


 Name

    XmTextSetSource - a Text function that sets the source of the widget

 Syntax


    #include <Xm/Text.h>

    void XmTextSetSource (widget, source, top_character, cursor_position)
    Widget widget;
    XmTextSource source;
    XmTextPosition top_character;
    XmTextPosition cursor_position;


 Description

    XmTextSetSource sets the source of the Text widget. Text widgets can
    share sources of text so that editing in one widget is reflected in
    another. This function sets the source of one widget so that it can share
    the source of another widget.

    Setting a new text source destroys the old text source if no other Text
    widgets are using that source.  To replace a text source but keep it for
    later use, create an unmanaged Text widget and set its source to the text
    source you want to keep.

    widget  Specifies the Text widget ID.

    source  Specifies the source with which the widget displays text. This
            can be a value returned by the XmTextGetSource(Xm) function. If
            no source is specified, the widget creates a default string
            source.

    topcharacter
            Specifies the position in the text to display at the top of the
            widget.  This is an integer number of characters from the begin-
            ning of the text buffer. The first character position is 0.

    cursorposition
            Specifies the position in the text at which the insert cursor is
            located. This is an integer number of characters from the begin-
            ning of the text buffer. The first character position is 0.

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

 See also

    XmText(Xm)