NAME

XmCreateFileSelectionDialog − The FileSelectionBox FileSelectionDialog convenience creation function

SYNOPSIS

#include <Xm/FileSB.h>
Widget XmCreateFileSelectionDialog (parent, name, arglist, argcount)

Widgetparent;
Stringname;
ArgListarglist;
Cardinalargcount;

DESCRIPTION

XmCreateFileSelectionDialog 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:

• An editable text field for the directory mask

• A scrolling list of filenames

• An editable text field for the selected file

• Labels for the list and text fields

• Four buttons

The default button labels are: OK, Filter, Cancel, and Help.  One additional WorkArea child may be added to the FileSelectionBox after creation. 

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

parent
Specifies the parent widget ID

nameSpecifies 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 FileSelectionBox and its associated resources, see XmFileSelectionBox(3X). 

RETURN VALUE

Returns the FileSelectionBox widget ID. 

RELATED INFORMATION

XmFileSelectionBox(3X). 

Hewlett-Packard Company  —  Motif Release 1.2: May 1992