SgCreateFileSelectionBox(3X)

NAME
     SgCreateFileSelectionBox --The FileSelectionBox widget creation function

SYNOPSIS
     #include <Xm/FileSB.h>

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


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

DESCRIPTION
     XmCreateFileSelectionBox  creates an unmanaged FileSelectionBox.  A FileSe-
     lectionBox is used to select a file and includes the following:


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

       *  A scrolling list of file and directory names

       *  An editable text field for the selected file

       *  Labels for the list and text fields

       *  Three buttons


     The  default  button labels are OK, Cancel, and Help.  Additional work area
     children may be added to the FileSelectionBox after  creation.   FileSelec-
     tionBox  inherits the layout functionality provided by SelectionBox for any
     additional work area children.

     If the parent of the FileSelectionBox is a DialogShell,  use  XtManageChild
     to pop up the FileSelectionDialog (passing the FileSelectionBox as the wid-
     get 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).

                                                    SgCreateFileSelectionBox(3X)