Man Linux: Main Page and Category List

NAME

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

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(library call)