'\" t
...\" CreFiB.sgm /main/8 1996/09/08 20:33:19 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 "XmCreateFileSelectionDialog" "library call"
.SH "NAME"
\fBXmCreateFileSelectionDialog\fP \(em The FileSelectionBox FileSelectionDialog convenience creation function
.iX "XmCreateFileSelection\\%Dialog"
.iX "creation functions" "XmCreateFileSelection\\%Dialog"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/FileSB\&.h>
\fBWidget \fBXmCreateFileSelectionDialog\fP\fR(
\fBWidget \fBparent\fR\fR,
\fBString \fBname\fR\fR,
\fBArgList \fBarglist\fR\fR,
\fBCardinal \fBargcount\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmCreateFileSelectionDialog\fP is a convenience creation function that
creates a DialogShell and an unmanaged FileSelectionBox child of the
DialogShell\&.
A FileSelectionDialog selects a file\&.
It includes the following:
.IP "   \(bu" 6
An editable text field for the directory mask
.IP "   \(bu" 6
A scrolling list of filenames
.IP "   \(bu" 6
An editable text field for the selected file
.IP "   \(bu" 6
Labels for the list and text fields
.IP "   \(bu" 6
Four buttons
.PP
The default button labels are
\fBOK\fP, \fBFilter\fP, \fBCancel\fP, and \fBHelp\fP\&. One additional
\fBWorkArea\fP child may be added to the FileSelectionBox after creation\&.
.PP
Use \fBXtManageChild\fP to pop up the FileSelectionDialog (passing the
FileSelectionBox
as the widget parameter); use \fBXtUnmanageChild\fP to pop it down\&.
.PP
\fBXmCreateFileSelectionDialog\fP forces the value of the Shell resource
\fBXmNallowShellResize\fP to True\&.
.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 FileSelectionBox and its associated resources, see
\fBXmFileSelectionBox\fP(3)\&.
.SH "RETURN"
.PP
Returns the FileSelectionBox widget ID\&.
.SH "RELATED"
.PP
\fBXmFileSelectionBox\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:20