XmTextSetSource - Man Page

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)​.

Referenced By

XmText(3), XmTextGetSource(3).