[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmCreateTemplateDialog

A MessageBox TemplateDialog convenience creation function

Format

#include <Xm/MessageB.h>
Widget XmCreateTemplateDialog
Widget
parentString nameArgList
arglistCardinal argcount

DESCRIPTION

XmCreateTemplateDialog is a convenience creation function that creates a DialogShell and an unmanaged MessageBox child of the DialogShell. The MessageBox widget's XmNdialogType resource is set to XmDIALOG_TEMPLATE. By default, the TemplateDialog widget contains only the separator child. You can build a customized dialog by adding children to the TemplateDialog.

You can create the standard MessageBox pushbuttons, Cancel , Help , and OK, by specifying the associated callback and label string resources. Setting XmNsymbolPixmap or XmNmessageString creates a symbol or message label.

Use XtManageChild to pop up the TemplateDialog (passing the MessageBox as the widget parameter); use XtUnmanageChild to pop it down.

XmCreateTemplateDialog forces the value of the Shell resource XmNallowShellResize to True.

parent
Specifies the parent widget ID

name
Specifies the name of the created widget

arglist
Specifies the argument list

argcount
Specifies the number of attribute/value pairs in the argument list ( arglist)

For a complete definition of MessageBox and its associated resources, see XmMessageBox (3).

RETURN

Returns the MessageBox widget ID.

RELATED

XmMessageBox (3).


[ Previous | Next | Contents | Glossary | Home | Search ]