Volume 6A: Motif Programming Manual

changed by the user in a resource file. For example, the following specification changes the title:

*Help.title: Help Dialog

The title can also be set using the XmNtitle resource, as shown in the following code fragment: XmNtitle is

defined identically to XtNtitle, which is an Xt resource, which means that the value is a regular character string,

not a compound string.

help_dialog = XtVaCreatePopupShell ("Help",

xmDialogShellWidgetClass, parent,

XmNtitle, "Help Dialog",

NULL);

When the title is hard−coded in the application, any resource specifications in a resource file are ignored.

8.3.2 The Manager Child

The next task is to create a manager widget that acts as the sole child of the DialogShell, since shell widgets can have

only one managed child. This section deals heavily with manager widget issues, so if you have problems keeping up,

you should look ahead to Chapter 8, Manager Widgets. However, the main point of the section is to provide enough

context for you to understand the source code We are using a PanedWindow widget as the child of the DialogShell, as

per our earlier recommendations. The PanedWindow is created as follows:

pane = XtVaCreateWidget ("pane",

xmPanedWindowWidgetClass, help_dialog,

XmNsashWidth, 1,

XmNsashHeight, 1,

NULL);

The PanedWindow manages two Form widget children, one each for the control area and the action area. These

children are also called the PanedWindow's panes. Normally, in a PanedWindow, the user can resize the panes by

moving the control sashes that ...