XmTextSetSource(3X)

NAME
     XmTextSetSource --A Text function that sets the source of the widget

SYNOPSIS
     #include <Xm/Text.h>

     void XmTextSetSource (widget, source, top_character, cursor_position)
          Widget    widget;
          XmTextSourcesource;
          XmTextPositiontop_character;
          XmTextPositioncursor_position;


VERSION
     This page documents version 1.2 of the Motif library.

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(3X)  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 wid-
            get.   This is an integer number of characters from the beginning of
            the text buffer.  The first character position is 0.

     cursor_position
            Specifies the position in the text at which the insert cursor is lo-
            cated.  This is an integer number of characters from  the  beginning
            of the text buffer.  The first character position is 0.


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

RELATED INFORMATION
     XmText(3X).

                                                             XmTextSetSource(3X)