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

More documents

Recommendations

Info

Using WidgetsOnce the widget is created, the client can change or de-allocate this list; the widgetitself makes no further reference to it. The closure field contains the client_datapassed to the callback when the callback list is executed.The second method for registering callbacks is to use XtAddCallback after thewidget has been created.void XtAddCallback( w, callback_name, callback, client_data);wcallback_namecallbackclient_dataSpecifies the widget to add the callback to.Specifies the callback list within the widget to appendto.Specifies the callback procedure to add.Specifies the data to be passed to the callback whenit is invoked.XtAddCallback adds the specified callback to the list for the named widget.All widgets provide a callback list named destroyCallback where clients can registerprocedures that are to be executed when the widget is destroyed. The destroycallbacks are executed when the widget or an ancestor is destroyed. The call_dataargument is unused for destroy callbacks.Programming ConsiderationsThis section provides some guidelines on how to set up an application program thatuses the X Toolkit.Writing ApplicationsWhen writing an application that uses the X Toolkit, you should make sure that yourapplication performs the following:1. Include < X11/Intrinsic.h > in your application programs. This header fileautomatically includes < X11/Xlib.h >, so all Xlib functions also are defined.It may also be necessary to include < X11/StringDefs.h > when setting upargument lists, as many of the XtNsomething definitions are only defined in thisfile.2. Include the widget-specific header files for each widget type that you need to use.For example, < X11/Xaw/Label.h > and < X11/Xaw/Command.h >.3. Call the XtAppInitialize function before invoking any other toolkit or Xlibfunctions. For further information, see Section 2.1 and the X Toolkit Intrinsics -C Language Interface.4. To pass attributes to the widget creation routines that will override any site oruser customizations, set up argument lists. In this document, a list of valid argumentnames is provided in the discussion of each widget. The names each havea global symbol defined that begins with XtN to help catch spelling errors. Forexample, XtNlabel is defined for the label resource of many widgets.5. For further information, see Section 2.9.2.2.15
Using Widgets6. When the argument list is set up, create the widget with the XtCreateManaged-Widget function. For further information, see Section 2.2 and the X Toolkit Intrinsics- C Language Interface.7. If the widget has any callback routines, set by the XtNcallback argument or theXtAddCallback function, declare these routines within the application.8. After creating the initial widget hierarchy, windows must be created for eachwidget by calling XtRealizeWidget on the top level widget.9. Most applications now sit in a loop processing events using XtAppMainLoop ,for example:10.XtCreateManagedWidget(name, class, parent, args, num_args);XtRealizeWidget(shell);XtAppMainLoop(app_context);11.For information about this function, see the X Toolkit Intrinsics - C LanguageInterface.12.Link your application with libXaw (the Athena widgets), libXmu (miscellaneousutilities), libXt (the X Toolkit Intrinsics), libSM (Session Management), libICE(Inter-Client Exchange), libXext (the extension library needed for the shape extensioncode which allows rounded Command buttons), and libX11 (the core Xlibrary). The following provides a sample command line:13.cc -o application application.c \-lXaw \-lXmu \-lXt \\-lSM \-lICE \-lXext \-lX11Changing Resource ValuesThe Intrinsics support two methods of changing the default resource values; the resourcemanager, and an argument list passed into XtCreateWidget. While resourcesvalues will get updated no matter which method you use, the two methods provideslightly different functionality.Resource ManagerArgument ListsThis method picks up resource definitions described in Xlib- C Language Interface from many different locations at runtime. The locations most important to the application programmerare the fallback resources and the app-defaults file, (see XToolkit Intrinsics - C Language Interface for the complete list).Since these resource are loaded at run time, they can be overriddenby the user, allowing an application to be customized tofit the particular needs of each individual user. These valuescan also be modified without the need to rebuild the application,allowing rapid prototyping of user interfaces. Applicationprogrammers should use resources in preference to hard-codedvalues whenever possible.The values passed into the widget at creation time via an argumentlist cannot be modified by the user, and allow no opportunityfor customization. It is used to set resources that cannotbe specified as strings (e.g. callback lists) or resources thatshould not be overridden (e.g. window depth) by the user.16
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: Using Widgetsnum_argsSpecifies the
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 43 and 44: Simple WidgetssliderWidthPanner Act
Page 47 and 48: Simple WidgetsRepeater ActionsThe R
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 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 and 98:
Text Widgetstypevalue_returnlength_
Page 99 and 100:
Text WidgetsResourcesSuperclass Tex
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 109 and 110:
Page 111 and 112:
Composite and ConstraintWidgetsLayo
Page 113 and 114:
Composite and ConstraintWidgets{Wid
Page 115 and 116:
Page 117 and 118:
Composite and ConstraintWidgetsAppl
Page 119 and 120:
Page 121 and 122:
Page 123 and 124:
Composite and ConstraintWidgets: Gr
Page 125 and 126:
Composite and ConstraintWidgetsReso
Page 127 and 128:
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?