NAME

       XmTextSetSource  —  A  Text  function that sets the source of the widget "XmTextSetSource"
       "Text functions" "XmTextSetSource"

SYNOPSIS

       #include <Xm/Text.h>
       void XmTextSetSource(
       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(3)  function.  If no source is specified, the
                 widget creates a default string source.

       top_character
                 Specifies the position in the text to display at the top of the widget.  This is
                 an integer number of characters from the beginning of the text buffer. The first
                 character position is 0 (zero).

       cursor_position
                 Specifies the position in the text at which the insert cursor is  located.  This
                 is  an  integer  number of characters from the beginning of the text buffer. The
                 first character position is 0 (zero).

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

RELATED

       XmText(3).

                                                                               XmTextSetSource(3)