XmFileSelectionBox(3)

NAME
XmFileSelectionBox - Motif-compatible file-selection dialogue

SYNOPSIS
#include <Xm/FileSB.h>

XmFileSelectionBox

XmCreateFileSelectionBox

DESCRIPTION
XmFileSelectionBox

X RESOURCES
Name | Class | Type | Default | Access
XmNdirectory | XmCDirectory | XmString | NULL | CSG
XmNpattern | XmCPattern | XmString | NULL | CSG
XmNdirListLabelString | XmCDirListLabelString | XmString | NULL | CSG
XmNdirListItems | XmCDirListItems | XmStringTable | NULL | CSG
XmNdirListItemCount | XmCDirListItemCount | Int | -1 | CSG
XmNfilterLabelString | XmCFilterLabelString | XmString | NULL | CSG
XmNdirMask | XmCDirMask | XmString | NULL | CSG
XmNnoMatchString | XmCNoMatchString | XmString | NULL | CSG
XmNqualifySearchDataProc | XmCQualifySearchDataProc | Proc | NULL | CSG
XmNdirSearchProc | XmCDirSearchProc | Proc | NULL | CSG
XmNfileSearchProc | XmCFileSearchProc | Proc | NULL | CSG
XmNfileTypeMask | XmCFileTypeMask | FileTypeMask | NULL | CSG
XmNlistUpdated | XmCListUpdated | Boolean | NULL | CSG
XmNdirectoryValid | XmCDirectoryValid | Boolean | NULL | CSG
XmNdirSpec | XmCDirSpec | XmString | NULL | CSG
XmNautoUnmanage | XmCAutoUnmanage | Boolean | NULL | CSG
XmNfileListLabelString | XmCFileListLabelString | XmString | NULL | CSG
XmNapplyLabelString | XmCApplyLabelString | XmString | NULL | CSG
XmNdialogType | XmCDialogType | SelectionType | NULL | CSG
XmNfileListItems | XmCItems | XmStringTable | NULL | CSG
XmNfileListItemCount | XmCItemCount | Int | -1 | CSG

XmNdirectory

XmNpattern

XmNdirListLabelString

XmNdirListItems

XmNdirListItemCount

XmNfilterLabelString

XmNdirMask

XmNnoMatchString

XmNqualifySearchDataProc

XmNdirSearchProc

XmNfileSearchProc

XmNfileTypeMask

XmNlistUpdated

XmNdirectoryValid

XmNdirSpec

XmNautoUnmanage

XmNfileListLabelString

XmNapplyLabelString

XmNdialogType

XmNfileListItems

XmNfileListItemCount

CLASS HIERARCHY
XObject(3) Rect(3) UnNamedObj(3) XCore(3) Composite(3) Constraint(3) XmManager(3) XmBulletinBoard(3) XmSelectionBox(3) XmFileSelectionBox(3)

CALLBACKS
XmFileSelectionBox has several callback lists, all of which are inherited from the superclass XmSelectionBox : XmNokCallback, XmNcancelCallback, XmNhelpCallback, XmNfilterCallback. In all these cases, the call_data parameter passed is of type XmFileSelectionBoxCallbackStruct :
  typedef struct {
    int reason;
    XEvent *event;
    XmString value;
    int length;
    XmString mask;
    int mask_length;
    XmString dir;
    int dir_length;
    XmString pattern;
    int pattern_length;
  } XmFileSelectionBoxCallbackStruct;

The reason field can have the values XmCR_OK, XmCR_NO_MATCH, XmCR_CANCEL, XmCR_HELP. The event field contains a pointer to the information from Xlib from the event that triggered this callback.

The other fields ...

SEARCH PROCEDURES
XmFileSelectionBox also has a number of resources which allow you to specify a (usually) system dependent function that helps it in traversing the filesystem. These are not callback lists as implemented in the Intrinsics; they can call one function with specific behaviour. They are : XmNqualifySearchDataProc, XmNdirSearchProc, XmNfileSearchProc.

XmNqualifySearchDataProc is called when ...

XmNdirSearchProc is called when ...

XmNfileSearchProc is called when ...

CONVENIENCE FUNCTIONS

SEE ALSO
<Xm/Xm.h>