NAME

XmCreatePromptDialog—The SelectionBox PromptDialog convenience creation function

SYNOPSIS

#include <Xm/SelectioB.h>
Widget XmCreatePromptDialog (parent, name, arglist, argcount)
Widgetparent;
Stringname;
ArgListarglist;
Cardinalargcount;

DESCRIPTION

XmCreatePromptDialog is a convenience creation function that creates a DialogShell and an unmanaged SelectionBox child of the DialogShell.  A PromptDialog prompts the user for text input.  It includes a message, a text input region, and three managed buttons.  The default button labels are OK, Cancel, and Help.  An additional button, with Apply as the default label, is created unmanaged; it may be explicitly managed if needed.  One additional WorkArea child may be added to the SelectionBox after creation. 

XmCreatePromptDialog forces the value of the SelectionBox resource XmNdialogType to XmDIALOG_PROMPT. 

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

parentSpecifies the parent widget ID

nameSpecifies the name of the created widget

arglistSpecifies the argument list

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

For a complete definition of SelectionBox and its associated resources, see XmSelectionBox(3X). 

RETURN VALUE

Returns the SelectionBox widget ID. 

RELATED INFORMATION

XmSelectionBox(3X). 

Sun Release 4.0  —  Last change: