'\" t
...\" CreSeB.sgm /main/7 1996/08/30 14:52:30 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmCreateSelectionDialog" "library call"
.SH "NAME"
\fBXmCreateSelectionDialog\fP \(em The SelectionBox SelectionDialog convenience creation function
.iX "XmCreateSelectionDialog"
.iX "creation functions" "XmCreateSelectionDialog"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/SelectioB\&.h>
\fBWidget \fBXmCreateSelectionDialog\fP\fR(
\fBWidget \fBparent\fR\fR,
\fBString \fBname\fR\fR,
\fBArgList \fBarglist\fR\fR,
\fBCardinal \fBargcount\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmCreateSelectionDialog\fP is a convenience creation function that creates
a DialogShell and an unmanaged SelectionBox child of the DialogShell\&.
A SelectionDialog offers the user a choice from a list of alternatives
and gets a selection\&.
It includes the following:
.IP "   \(bu" 6
A scrolling list of alternatives
.IP "   \(bu" 6
An editable text field for the selected alternative
.IP "   \(bu" 6
Labels for the text field
.IP "   \(bu" 6
Four buttons
.PP
The default button labels are \fBOK\fP, \fBCancel\fP, \fBApply\fP,
and \fBHelp\fP\&.
One additional \fBWorkArea\fP child may be added to the
SelectionBox after creation\&.
.PP
\fBXmCreateSelectionDialog\fP forces the value of the SelectionBox resource
\fBXmNdialogType\fP to \fBXmDIALOG_SELECTION\fP\&.
.PP
\fBXmCreateSelectionDialog\fP forces the value of the Shell resource
\fBXmNallowShellResize\fP to True\&.
.PP
Use \fBXtManageChild\fP to pop up the SelectionDialog (passing the
SelectionBox as the widget parameter);
use \fBXtUnmanageChild\fP to pop it down\&.
.IP "\fIparent\fP" 10
Specifies the parent widget ID
.IP "\fIname\fP" 10
Specifies the name of the created widget
.IP "\fIarglist\fP" 10
Specifies the argument list
.IP "\fIargcount\fP" 10
Specifies the number of attribute/value pairs in the argument list
(\fIarglist\fP)
.PP
For a complete definition of SelectionBox and its associated resources, see
\fBXmSelectionBox\fP(3)\&.
.SH "RETURN"
.PP
Returns the SelectionBox widget ID\&.
.SH "RELATED"
.PP
\fBXmSelectionBox\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:21