Volume 6A: Motif Programming Manual

The reference pages for the Text and TextField widgets (in Volume Six B, Motif Reference Manual; Section 2, Motif

and Xt Widget Classes) lists the default translations for the widgets. See Volume Four, X Toolkit Intrinsics

Programming Manual, for a description of how to programmatically alter translation tables; see Volume Three, X

Window System User's Guide, for a description of how a user can customize widget translations. See Chapter 17, The

Clipboard, for a discussion of the lower−level Motif clipboard functions.

15.2 Text Widget Basics

In order to understand the complexities of the Text and TextField widgets, you need to know about some of the basic

resources and functions that they provide. This section describes the fundamentals of working with text widgets,

including how to create the widgets, how to work with the textual data, and how to control simple aspects of

appearance and behavior. Applications that wish to use the Text widget need to include the file <Xm/Text.h>.

TextField widgets require the file <Xm/TextF.h>. You can create a Text widget using

XtVaCreateManagedWidget() as usual:

Widget text_w;

text_w = XtVaCreateManagedWidget("name",

xmTextWidgetClass, parent,

resource−value−list,

NULL);

To create a TextField widget instead, specify the class as xmTextFieldWidgetClass.

15.2.1 The Textual Data

The XmNvalue resource of the Text and TextField widgets provides the most basic means of access to the internal

text storage for the widgets. Unlike the other widgets in the Motif toolkit ...