XmCreateFileSelectionDialog(X3mot)
XmCreateFileSelectionDialog --
the FileSelectionBox FileSelectionDialog convenience creation function
Synopsis
#include <Xm/FileSB.h>
Widget XmCreateFileSelectionDialog (parent, name, arglist, argcount)
Widget parent;
String name;
ArgList arglist;
Cardinal argcount;
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
- name
-
Specifies 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(X3mot).
Return values
Returns the FileSelectionBox widget ID.
References
XmFileSelectionBox(X3mot)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.