Specifications

Athena Widget Set libXaw 1.0.7
Class dialogWidgetClass
Class Name Dialog
Superclass Form
The Dialog widget implements a commonly used interaction semantic to prompt for auxiliary
input from a user.For example, you can use a Dialog widget when an application requires a
small piece of information, such as a filename, from the user.ADialog widget, which is simply a
special case of the Form widget, provides a convenient way to create a preconfigured form.
The typical Dialog widget contains three areas. The first line contains a description of the func-
tion of the Dialog widget, for example, the string Filename:.The second line contains an area
into which the user types input. The third line can contain buttons that let the user confirm or
cancel the Dialog input. Anyofthese areas may be omitted by the application.
6.2.1. Resources
When creating a Dialog widget instance, the following resources are retrievedfrom the argument
list or the resource database:
Name Class Type Notes Default Value
accelerators Accelerators AcceleratorTable NULL
ancestorSensitive AncestorSensitive Boolean D True
background Background Pixel XtDefaultBackground
backgroundPixmap Pixmap Pixmap XtUnspecifiedPixmap
borderColor BorderColor Pixel XtDefaultForeground
borderPixmap Pixmap Pixmap XtUnspecifiedPixmap
borderWidth BorderWidth Dimension 1
children ReadOnly WidgetList R NULL
colormap Colormap Colormap Parent’sColormap
defaultDistance Thickness int 4
depth Depth int C Parent’sDepth
destroyCallback Callback XtCallbackList NULL
height Height Dimension A Enough space to contain all children
icon Icon Bitmap None
label Label String "label"
mappedWhenManaged MappedWhenManaged Boolean True
numChildren ReadOnly Cardinal R 0
screen Screen Screen R Parent’sScreen
sensitive Sensitive Boolean True
translations Translations TranslationTable NULL
value Value String no value widget
width Width Dimension AEnough space to contain all children
xPosition Position 0
yPosition Position 0
accelerators A list of event to action bindings to be executed by this widget, even
though the event occurred in another widget. (See the XToolkit Intrin-
sics — C Language Interface for details).
ancestorSensitive The sensitivity state of the ancestors of this widget. Awidget is insensi-
tive ifeither it or anyofits ancestors is insensitive.This resource should
not be changed with XtSetValues,although it may be queried.
background A pixel value which indexesthe widget’scolormap to derive the back-
ground color of the widget’swindow.
backgroundPixmap The background pixmap of this widget’swindow. Ifthis resource is set
to anything other than XtUnspecifiedPixmap,the pixmap specified will
111