Specifications

Athena Widget Set libXaw 1.0.7
resources to point to an MultiSink and MultiSrc respectively.When
international is set to false the AsciiTextwidget initializes these
resources to point to an AsciiSink and AsciiSrc respectively.
translations The ev e nt bindings associated with this widget.
type This resource may be either XawAsciiString or XawAsciiFile.The
value of this resource determines whether the string resource contains
the name of a file to be opened or a buffer to be displayed by the text
widget. A converter has been registered for this resource and accepts the
values string and file.This is a resource of the associated source.
useStringInPlace Setting this resource to True will disable the memory management pro-
vided by the Textwidget, updating the string resource in place. Using
the string in place can be much more efficient for text widgets that dis-
play static data, or where the programmer wishes to impose strict con-
straints on the contents of the string.When using the string in place be
sure that: the length of the string is specified by setting the length
resource, the type of the Textwidget is XawAsciiString,and that the
string exists for the lifetime of the text widget, or until it has been reset.
Note: Since the MultiSrcand AsciiSrchave different data formats, use of
this resource forces application code to be cognisant as to whichofthe
two is being used. Application programming is simplified when use of
this resource is avoided. This is a resource of the associated source.
wrap When the text in anyone line is wider than the windowthere are several
possible actions. This resource allows the user to decide what will hap-
pen. The accepted values for this resource are XawtextWrapNever,
XawtextWrapLine,and XawtextWrapWord.With Xawtex-
tWrapLine all text that is beyond the right edge of the windowwill be
displayed on the next line. With XawtextWrapWord the same action
occurs but the text is broken at a word boundary if possible. If no wrap-
ping is enabled then the text will extend offthe edge of the window, and
asmall rectangle will be painted in the right margin to alert the user that
this line is too long. Aconverter is registered for this resource that will
convert the following strings: never, word, and line.
x
yThe location of the upper left outside corner of this widget in its parent.
5.6. Ascii Source Object and Multi Source Object
Application Header file <X11/Xaw/AsciiSrc.h> or <X11/Xaw/MultiSrc.h>
Class Header file <X11/Xaw/AsciiSrcP.h> or <X11/Xaw/MultiSrcP.h>
Class asciiSrcObjectClass or multiSrcObjectClass
Class Name AsciiSrc or MultiSrc
Superclass TextSource
The AsciiSrc or MultiSrc object is used by a text widget to read the text from a file or string in
memory.Depending on its international resource, an AsciiTextwidget will create one or the
other of these when the AsciiTextitself is created. Both types are nearly identical; the following
discussion applies to both, with MultiSrc differences noted only as theyoccur.
The AsciiSrc understands all Latin1 characters plus Tab and Carriage Return. The MultiSrc
understands any set of character sets that the underlying X implementation’sinternationalization
handles.
91