[Contents] [Index] [Next] [Previous]

XmTextSetSource


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;
      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(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 widget. 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 located. 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 XmText(3X).

RELATED INFORMATION

XmText(3X).