Specifications

Athena Widget Set libXaw 1.0.7
1.5. Format of the Widget Reference Chapters
The majority of this document is a reference guide for the Athena widget set. Chapters three
through six give the programmer all information necessary to use the widgets. The layout of the
chapters follows a specific pattern to allowthe programmer to easily find the desired information.
The first fewpages of every chapter give anoverviewofthe widgets in that section. Widgets are
grouped into chapters by functionality.
Chapter 3 Simple Widgets
Chapter 4 Menus
Chapter 5 Te x tWidgets
Chapter 6 Composite and Constraint Widget
Following the introduction will be a description of each widget in that chapter.When no func-
tional grouping is obvious the widgets are listed in alphabetical order,such as in chapters three
and six.
The first section of each widget’sdescription is a table that contains general information about
this widget class. Here is the table for the Box widget, and an explanation of all the entries.
Application Header file <X11/Xaw/Box.h>
Class Header file <X11/Xaw/BoxP.h>
Class boxWidgetClass
Class Name Box
Superclass Composite
Application Header File This file must be included when an application uses this widget.
It usually contains the class definition, and some resource
macros. This is often called the ‘‘public’’header file.
Class Header File This file will only be used by widget programmers. It will need
to be included by anywidget that subclasses this widget. This is
often called the ‘‘private’’header file.
Class This is the widget class of this widget. This global symbol is
passed to XtCreateWidget so that the Intrinsics will know
which type of widget to create.
Class Name This is the resource name of this class. This name can be used in
aresource file to match anywidget of this class.
Superclass This is the superclass that this widget class is descended from. If
you understand howthe superclass works it will allowyou to
more quickly understand what this widget does, since much of
its functionality may be inherited from its superclass.
After this table follows a general description of the default behavior of this widget, as seen by the
user.Inmanycases this functionality may be overridden by the application programmer,orby
the user.
The next section is a table showing the name, class, type and default value of each resource that is
available to this widget. There is also a column containing notes describing special restrictions
placed upon individual resources.
AThis resource may be automatically adjusted when another resource is changed.
CThis resource is only settable at widget creation time, and may not be modified with
XtSetValues.
4