# Ascii Text Widget

    Application Header file	<X11/Xaw/AsciiText.h>

    ClassHeader file	<X11/Xaw/AsciiTextP.h>

    Class		asciiTextWidgetClass

    Class Name	Text

    Superclass	Text
    Sink Name	textSink
    Source Name	textSource

For the ease of internationalization, the AsciiText widget class name has not been changed, although it is actually able to support non-ASCII locales. The AsciiText widget is really a collection of smaller parts. It includes the Text widget itself, a ``Source'' (which supports memory management), and a ``Sink'' (which handles the display). There are currently two supported sources, the AsciiSrc and MultiSrc, and two supported sinks, the AsciiSink and MultiSink. Some of the resources listed below are not actually resources of the AsciiText, but belong to the associated source or sink. This is is noted in the explanation of each resource where it applies. When specifying these resources in a resource file it is necessary to use *AsciiText*resource_name instead of *AsciiText.resource_name, since they actually belong to the children of the AsciiText widget, and not the AsciiText widget itself. However, these resources may be set directly on the AsciiText widget at widget creation time, or via `XtSetValues`.

## Resources

When creating an AsciiText widget instance, the following resources are retrieved from the argument list or from the resource database:

Name | Class | Type | Notes | Default Value
--- | --- | --- | --- | ---
accelerators | Accelerators | AcceleratorTable |  | NULL
ancestorSensitive | AncestorSensitive | Boolean | D | True
autoFill | AutoFill | Boolean |  | False
background | Background | Pixel |  | XtDefaultBackground
backgroundPixmap | Pixmap | Pixmap |  | XtUnspecifiedPixmap
borderColor | BorderColor | Pixel |  | XtDefaultForeground
borderPixmap | Pixmap | Pixmap |  | XtUnspecifiedPixmap
borderWidth | BorderWidth | Dimension |  | 1
bottomMargin | Margin | Position |  | 2
callback | Callback | XtCallbackList |  | NULL
colormap | Colormap | Colormap |  | Parent's Colormap
cursor | Cursor | Cursor |  | XC_xterm
cursorName | Cursor | String |  | NULL
dataCompression | DataCompression | Boolean |  | True
depth | Depth | int | C | Parent's Depth
destroyCallback | Callback | XtCallbackList |  | NULL
displayCaret | Output | Boolean |  | True
displayNonprinting | Output | Boolean |  | True
displayPosition | TextPosition | XawTextPosition |  | 0
echo | Output | Boolean |  | True
editType | EditType | XawTextEditType |  | XawtextRead
font | Font | XFontStruct* |  | XtDefaultFont
fontSet | FontSet | XFontSet |  | XtDefaultFontSet
foreground | Foreground | Pixel |  | XtDefaultForeground
height | Height | Dimension | A | Font height + margins
insensitiveBorder | Insensitive | Pixmap |  | GreyPixmap
insertPosition | TextPosition | int |  | 0
international | International | Boolean | C | False
leftMargin | Margin | Dimension |  | 2
length | Length | int | A | length of `string`
mappedWhenManaged | MappedWhenManaged | Boolean |  | True
pieceSize | PieceSize | XawTextPosition |  | BUFSIZ
pointerColor | Foreground | Pixel |  | XtDefaultForeground
pointerColorBackground | Background | Pixel |  | XtDefaultBackground
resize | Resize | XawTextResizeMode |  | XawtextResizeNever
rightMargin | Margin | Position |  | 2
screen | Screen | Screen | R | Parent's Screen
scrollHorizontal | Scroll | XawTextScrollMode |  | XawtextScrollNever
scrollVertical | Scroll | XawTextScrollMode |  | XawtextScrollNever
selectTypes | SelectTypes | XawTextSelectType* |  | See above
sensitive | Sensitive | Boolean |  | True
string | String | String |  | NULL
textSink | TextSink | Widget |  | An AsciiSink
textSource | TextSource | Widget |  | An AsciiSrc
topMargin | Margin | Position |  | 2
translations | Translations | TranslationTable |  | See above
type | Type | XawAsciiType |  | XawAsciiString
useStringInPlace | UseStringInPlace | Boolean |  | False
width | Width | Dimension |  | 100
wrap | Wrap | WrapMode |  | XawtextWrapNever
x | Position | Position |  | 0
y | Position | Position |  | 0