[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Programmer's Reference


XmCreateFileSelectionDialog

The FileSelectionBox FileSelectionDialog convenience creation function

Format

#include <Xm/FileSB.h>
Widget XmCreateFileSelectionDialog
Widget
parentString nameArgList
arglistCardinal 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:

  1. An editable text field for the directory mask

  2. A scrolling list of filenames

  3. An editable text field for the selected file

  4. Labels for the list and text fields

  5. Four buttons
  6. 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).


    [ Previous | Next | Contents | Glossary | Home | Search ]