NAME
Simple widget − Core subclass with cursor control and insensitivity indication.
SYNOPSIS
Public Headers:<X11/StringDefs.h> <X11/Xaw/Simple.h>
Private Header:<X11/Xaw/SimpleP.h>
Class Name:Simple
Class Pointer:simpleWidgetClass
Instantiation:This widget is not normally instantiated.
CLASS HIERARCHY
Core → Simple
DESCRIPTION
The Simple widget is not very useful by itself, as it has no semantics of its own. Its main purpose is to be used as a common superclass for the other simple (non-composite) Athena widgets. It might also be a good superclass to use for widgets you write. This widget adds five resources to the resource list provided by the Core widget and its superclasses.
RESOURCES
When creating a Simple widget instance, the following resources are retrieved from the argument list or from the resource database:
| Name (XtN...) | Type | Default | Description | |||
| XtNaccelerators | Accelerator- Table |
NULL | List of event-to-action bindings to be executed by this widget, even though the event occurred in another widget. | |||
| XtNancestorSensitive | Boolean | True | (D) Sensitivity state of the ancestors of this widget: a widget is insensitive if either it or any of its ancestors is insensitive. | |||
| XtNbackground | Pixel | XtDefault− Background |
Window background color. | |||
| XtNbackgroundPixmap | Pixmap | XtUnspecified− Pixmap |
Window background pixmap. | |||
| XtNborderColor | Pixel | XtDefault− Foreground |
Window border color. | |||
| XtNborderPixmap | Pixmap | XtUnspecified− Pixmap |
Window border pixmap. | |||
| XtNborderWidth | Dimension | 1 | Border width in pixels. | |||
| XtNcolormap | Colormap | Parent’s colormap. | Colormap that this widget will use. | |||
| XtNcursor | Cursor | None | Pointer cursor. | |||
| (R5) XtNcursorName | String | NULL | ||||
| XtNdepth | int | Parent’s depth. | (C) Depth of this widget’s window. | |||
| XtNdestroyCallback | XtCallback- List |
NULL | Callbacks for XtDestroyWidget(). | |||
| XtNheight | Dimension | Font height + 2 ∗ XtNinternalHeight |
Height of widget. | |||
| XtNinsensitiveBorder | Pixmap | Gray pixmap. | Border when not sensitive. | |||
| XtNinternalHeight | Dimension | 2 | See note. | |||
| XtNmappedWhenManaged | Boolean | TRUE | Whether XtMapWidget() is automatic. | |||
| (R5) XtNpointerColor | Pixel | XtDefaultForeground | ||||
| (R5) XtNpointerColor- Background |
Pixel | XtDefaultBackground | ||||
| XtNscreen | Screen | Parent’s screen. | (R) Screen on which this widget is displayed: this is not a settable resource. | |||
| XtNsensitive | Boolean | TRUE | Whether widget receives input. | |||
| XtNtranslations | Translation− Table |
See below. | Event-to-action translations. | |||
| XtNwidth | Dimension | XtNlabel width +2 ∗ XtNinternalWidth | Width of widget. | |||
| XtNx | Position | 0 | x coordinate in pixels. | |||
| XtNy | Position | 0 | y coordinate in pixels. | |||
The new resources associated with Simple are:
XtNcursor
Specifies a cursor to be used in the widget’s window. You must create the cursor before setting this resource in C code.
XtNcursorName
Specifies a cursor by name to be used in the widget’s window. This saves you from having to create a cursor yourself. You supply just a name from the standard cursor font. New in R5.
XtNinsensitiveBorder
Specifies a pixmap that will be used for the border when the widget is insensitive.
XtNpointerColor
Specifies a foreground color used when creating the cursor specified in XtNcursorName. If this is changed then a new cursor will be recreated. New in R5.
XtNpointerColorBackground
Specifies a background color used when creating the cursor specified in XtNcursorName. If this is changed then a new cursor will be recreated. New in R5.