Athena Widget Set - C Language Interface - X Consortium ... - X.Org

More documents

Recommendations

Info

Text WidgetsResourcesother of these when the AsciiText itself is created. Both types are nearly identical;the following discussion applies to both, with MultiSink differences noted only asthey occur. The AsciiSink will display all printing characters in an 8 bit font, alongwith handling Tab and Carriage Return. The name has been left as ``AsciiSink'' forcompatibility. \fIThe MultiSink will display all printing characters in a font set, alongwith handling Tab and Carriage Return.\fP The source object also reports the textwindow metrics to the text widgets.When creating an AsciiSink object instance, the following resources are retrievedfrom the argument list or from the resource database:Name Class Type Notes Default Valuebackground Background Pixel XtDefault-Backgrounddestroy-CallbackdisplayNonprintingCallback XtCallbackList NULLOutput Boolean Trueecho Output Boolean Truefont Font XFontStruct* XtDefaultFontfontSet FontSet XFontSet XtDefault-FontSetforeground Foreground Pixel XtDefault-Foreground_This resource is retrieved by the AsciiSink instead of being copied from the Textwidget.The text font to use when displaying the string. (This resource is present in theAsciiSink, but not the MultiSink.)The text font set to use when displaying the string. (This resource is present in theMultiSink, but not the AsciiSink.)Ascii Source Object and Multi Source ObjectApplication Header file or Class Header file or Class asciiSrcObjectClass or multiSrcObjectClassClass Name AsciiSrc or MultiSrc93
Text WidgetsResourcesSuperclass TextSourceThe AsciiSrc or MultiSrc object is used by a text widget to read the text from afile or string in memory. Depending on its international resource, an AsciiTextwidget will create one or the other of these when the AsciiText itself is created. Bothtypes are nearly identical; the following discussion applies to both, with MultiSrcdifferences noted only as they occur.The AsciiSrc understands all Latin1 characters plus Tab and Carriage Return.\fIThe MultiSrc understands any set of character sets that the underlying Ximplementation's internationalization handles.\fPThe AsciiSrc can be either of two types: XawAsciiFile or XawAsciiString.AsciiSrc objects of type XawAsciiFile read the text from a file and store it into aninternal buffer. This buffer may then be modified, provided the text widget is in thecorrect edit mode, just as if it were a source of type XawAsciiString. Unlike R3 andearlier versions of the AsciiSrc, it is now possible to specify an editable disk source.The file is not updated, however, until a call to XawAsciiSave is made. When thesource is in this mode the useStringInPlace resource is ignored.AsciiSrc objects of type XawAsciiString have the text buffer implemented as astring. \fIMultiSrc objects of type XawAsciiString have the text buffer implementedas a wide character string.\fP The string owner is responsible for allocating andmanaging storage for the string.In the default case for AsciiSrc objects of type XawAsciiString, the resourceuseStringInPlace is false, and the widget owns the string. The initial value of thestring resource, and any update made by the application programmer to the stringresource with XtSetValues, is copied into memory private to the widget, and managedinternally by the widget. The application writer does not need to worry aboutrunning out of buffer space (subject to the total memory available to the application).The performance does not decay linearly as the buffer grows large, as is necessarilythe case when the text buffer is used in place. The application writer mustuse XtGetValues to determine the contents of the text buffer, which will return acopy of the widget's text buffer as it existed at the time of the XtGetValues call.This copy is not affected by subsequent updates to the text buffer, i.e., it is not updatedas the user types input into the text buffer. This copy is freed upon the nextcall to XtGetValues to retrieve the string resource; however, to conserve memory,there is a convenience routine, XawAsciiSourceFreeString, allowing the applicationprogrammer to direct the widget to free the copy.When the resource useStringInPlace is true and the AsciiSrc object is of typeXawAsciiString, the application is the string owner. The widget will take the valueof the string resource as its own text buffer, and the length resource indicates thebuffer size. In this case the buffer contents change as the user types at the widget;it is not necessary to call XtGetValues on the string resource to determine thecontents of the buffer-it will simply return the address of the application's implementationof the text buffer.When creating an AsciiSrc object instance, the following resources are retrievedfrom the argument list or from the resource database:94
Page 1 and 2:
Athena Widget Set -C Language Inter
Page 3 and 4:
Table of Contents1. Athena Widgets
Page 5 and 6:
Athena Widget Set -C Language Inter
Page 7 and 8:
Athena Widgetsand The Intrinsicswid
Page 9 and 10:
Athena Widgetsand The Intrinsics•
Page 11 and 12:
Athena Widgetsand The IntrinsicsDRD
Page 13 and 14:
Using Widgetsapplication_classoptio
Page 15 and 16:
Using WidgetsName Class Type Defaul
Page 17 and 18:
Using Widgetsapp_contextSpecifies t
Page 19 and 20:
Using Widgetsnum_argsSpecifies the
Page 21 and 22:
Using Widgets6. When the argument l
Page 23 and 24:
Using Widgetseither the name used t
Page 25 and 26:
Using WidgetsArg arglist[10];arglis
Page 27 and 28:
Simple WidgetsSuperclass LabelResou
Page 29 and 30:
Simple Widgets• Processing applic
Page 31 and 32:
Simple WidgetsName Class Type Notes
Page 33 and 34:
Simple WidgetsResourceswill allow i
Page 35 and 36:
Simple WidgetsResourcesWhen creatin
Page 37 and 38:
Simple WidgetsforegroundA pixel val
Page 39 and 40:
Simple WidgetsresizeSpecifies a Boo
Page 41 and 42:
Page 43 and 44:
Simple WidgetssliderWidthPanner Act
Page 45 and 46:
Page 47 and 48: Simple WidgetsRepeater ActionsThe R
Page 49 and 50: Simple WidgetsName Class Type Notes
Page 51 and 52: Simple Widgetsbacks and passes eith
Page 53 and 54: Simple WidgetsSimple Widget\ * reso
Page 55 and 56: Simple WidgetsResourcesThe StripCha
Page 57 and 58: Simple Widgetsvoid(*getValueProc)(
Page 59 and 60: Simple WidgetsName Class Type Notes
Page 61 and 62: Simple Widgetsnotify()When the Togg
Page 63 and 64: Chapter 4. MenusThe Athena widget s
Page 65 and 66: MenusNotify(\|)Called when the user
Page 67 and 68: MenusleftBitmaprightBitmapThis is a
Page 69 and 70: Chapter 5. Text WidgetsThe Text wid
Page 71 and 72: Text Widgetswill be insensitive and
Page 73 and 74: Text WidgetsTwoThreeFourFiveSelect
Page 75 and 76: Text Widgetsscroll-one-line-up()scr
Page 77 and 78: Text Widgetskill-to-end-of-paragrap
Page 79 and 80: Text Widgetsreconnect-im()The popup
Page 81 and 82: Text WidgetsText FunctionsLeft: bac
Page 83 and 84: Text Widgetsint XawTextReplace( w,
Page 85 and 86: Text WidgetsCalling this function i
Page 87 and 88: Text WidgetsClass Header fileClassC
Page 89 and 90: Text WidgetsResourcesClass Name Tex
Page 91 and 92: Text WidgetsClearing Portions of th
Page 93 and 94: Text WidgetsFinding the Size of the
Page 95 and 96: Text WidgetsXawTextPosition Read( w
Page 97: Text Widgetstypevalue_returnlength_
Page 101 and 102: Text WidgetsBoolean XawAsciiSaveAsF
Page 103 and 104: Text WidgetsName Class Type Notes D
Page 105 and 106: Chapter 6. Composite and Constraint
Page 107 and 108: Composite and ConstraintWidgetsName
Page 111 and 112: Composite and ConstraintWidgetsLayo
Page 113 and 114: Composite and ConstraintWidgets{Wid
Page 117 and 118: Composite and ConstraintWidgetsAppl
Page 123 and 124: Composite and ConstraintWidgets: Gr
Page 125 and 126: Composite and ConstraintWidgetsReso
Page 129 and 130: Composite and ConstraintWidgetsAppl
Page 131 and 132: Composite and ConstraintWidgetsLayo
Page 133 and 134: Creating New Widgets(Subclassing)It
Page 135 and 136: Creating New Widgets(Subclassing)dr
Page 137 and 138: Creating New Widgets(Subclassing)st
Page 139 and 140: Creating New Widgets(Subclassing)In
Page 141: AcknowledgmentsDonna ConverseMIT X
show all

Athena Widget Set - C Language Interface - X Consortium ... - X.Org

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?