...\" **  (c) Copyright 1993, 1994 Hewlett-Packard Company
...\" **  (c) Copyright 1993, 1994 International Business Machines Corp.
...\" **  (c) Copyright 1993, 1994 Sun Microsystems, Inc.
...\" **  (c) Copyright 1993, 1994 Novell, Inc
...\" **
...\" **
...\" **
...\" **  (c) Copyright 1989, 1990, 1992 by Open Software Foundation, Inc.
...\" **      All Rights Reserved.
...\" **
...\" **  (c) Copyright 1987, 1988, 1989, by Hewlett-Packard Company
...\" **
...\" **  (c) Copyright 1987, 1988 by Digital Equipment Corporation,
...\" **      Maynard, MA.  All Rights Reserved.
...\" **
...\" **
.TH XmCreatePromptDialog 3X "" "" "" ""
.ds )H Hewlett-Packard Company
.ds ]W Motif Release 1.2: May 1992
.SH NAME
\fIXmCreatePromptDialog\fP \- The SelectionBox PromptDialog convenience creation function
.SH SYNOPSIS
.nf
.sS
.iS
\&#include <Xm/SelectioB.h>
.sp \n(PDu
Widget XmCreatePromptDialog (\fBparent, name, arglist, argcount\fI)
.ta .5i 1.5i
.nf
	Widget	\fBparent\fI;
	String	\fBname\fI;
	ArgList	\fBarglist\fI;
	Cardinal	\fBargcount\fI;
.wH
.fi
.iE
.sE
.SH DESCRIPTION
.fi
\fIXmCreatePromptDialog\fP 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 \fIOK\fP, \fICancel\fP, and \fIHelp\fP.
An additional button, with \fIApply\fP as the default label, is created
unmanaged; it may be explicitly managed if needed.  One additional
\fIWorkArea\fP child may be added to the SelectionBox after creation.
.PP 
\fIXmCreatePromptDialog\fP forces the value of the SelectionBox resource
\fIXmNdialogType\fP to \fIXmDIALOG_PROMPT\fP.
.PP 
Use \fIXtManageChild\fP to pop up the PromptDialog (passing the SelectionBox
as the widget parameter); use \fIXtUnmanageChild\fP to pop it down.
.nL
.ne 4
.IP "\fBparent\fP"
Specifies the parent widget ID
.IP "\fBname\fP"
Specifies the name of the created widget
.IP "\fBarglist\fP"
Specifies the argument list
.IP "\fBargcount\fP"
Specifies the number of attribute/value pairs in the argument list
(\fBarglist\fP)
.PP 
For a complete definition of SelectionBox and its associated resources, see
\fIXmSelectionBox(3X)\fP.
.SH RETURN VALUE
Returns the SelectionBox widget ID.
.SH RELATED INFORMATION
.na
\fIXmSelectionBox(3X)\fP.
.ad