SgCreateFileSelectionDialog(3X)

     NAME
          SgCreateFileSelectionDialog - The FileSelectionDialog
          convenience creation function

     SYNOPSIS
          #include <Xm/FileSB.h>

          Widget XmCreateFileSelectionDialog (parent, name, arglist, argcount)
               Widget    parent;
               String    name;
               ArgList   arglist;
               Cardinal  argcount;


     VERSION
          This page documents the version of Sgm that accompanies
          Motif 2.1.

     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:


            o  A directory menu showing the current directory and the
               directories above it

            o  A scrolling list of file and directory names

            o  An editable text field for the selected file

            o  Labels for the list and text fields

            o  Three buttons


          The default button labels are:  OK, Cancel, and Help.

          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

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

     RETURN VALUE
          Returns the FileSelectionBox widget ID.

     RELATED INFORMATION
          SgFileSelectionBox(3X).