oracular (3) XmCreateFileSelectionDialog.3.gz

NAME

       XmCreateFileSelectionDialog  —  The  FileSelectionBox  FileSelectionDialog  convenience creation function
       "XmCreateFileSelection\%Dialog" "creation functions" "XmCreateFileSelection\%Dialog"

SYNOPSIS

       #include <Xm/FileSB.h>
       Widget XmCreateFileSelectionDialog(
       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.

       XmCreateFileSelectionDialog forces the value of the Shell resource XmNallowShellResize to True.

       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(3).

RETURN

       Returns the FileSelectionBox widget ID.

RELATED

       XmFileSelectionBox(3).

                                                                                  XmCreateFileSelectionDialog(3)