Dialog Template widget

The Dialog Template widget is an instance of a specific type of Message Box widget and is new to Motif 1.2.

The widget is a specialized version of a Message Box widget and shares the same resource panel in WorkShop Visual. Much of the behavior of the Dialog Template is ultimately derived from the Bulletin Board widget and so it also shares these resources.

The widget is intended to enable applications to create a customized dialog. Unlike a full Message Box, the Dialog Template does not display either a symbol or a message as it contains by default only a Separator gadget child; you can add these items yourself if you wish, or just use a Message Box.

As with the Message Box, the widget will apply layout assumptions to any child widgets you add: buttons will appear below the Separator, other widgets above. You may optionally add both a MenuBar widget and a Work Area widget which will appear above the Separator. The Work area widget can be almost any type of widget you want.

Since the Dialog Template widget contains initially only a Separator, the resource panel makes insensitive all the button gadget resources which are applicable to the full Message Box.

Because the Separator gadget is built-in, it cannot be moved or cut from the design.

For more information, consult XmMessageBox(3X) in the OSF/Motif Programmer's Reference.

NOTES

If you want to add many widgets to your Dialog Template, consider making the Work Area child a Form widget, which you can then use to contain whatever extra functionality you desire.

Consider using a Message Box directly and unmanage the built-in gadgets of which you have no use.

See also: