XmFileSelectionBox(3) Motif-compatible file-selection dialogue

SYNOPSIS

#include <Xm/FileSB.h>

XmFileSelectionBox

XmCreateFileSelectionBox

DESCRIPTION

XmFileSelectionBox

X RESOURCES

NameClassTypeDefaultAccess

XmNdirectoryXmCDirectoryXmStringNULLCSG
XmNpatternXmCPatternXmStringNULLCSG
XmNdirListLabelStringXmCDirListLabelStringXmStringNULLCSG
XmNdirListItemsXmCDirListItemsXmStringTableNULLCSG
XmNdirListItemCountXmCDirListItemCountInt-1CSG
XmNfilterLabelStringXmCFilterLabelStringXmStringNULLCSG
XmNdirMaskXmCDirMaskXmStringNULLCSG
XmNnoMatchStringXmCNoMatchStringXmStringNULLCSG
XmNqualifySearchDataProcXmCQualifySearchDataProcProcNULLCSG
XmNdirSearchProcXmCDirSearchProcProcNULLCSG
XmNfileSearchProcXmCFileSearchProcProcNULLCSG
XmNfileTypeMaskXmCFileTypeMaskFileTypeMaskNULLCSG
XmNlistUpdatedXmCListUpdatedBooleanNULLCSG
XmNdirectoryValidXmCDirectoryValidBooleanNULLCSG
XmNdirSpecXmCDirSpecXmStringNULLCSG
XmNautoUnmanageXmCAutoUnmanageBooleanNULLCSG
XmNfileListLabelStringXmCFileListLabelStringXmStringNULLCSG
XmNapplyLabelStringXmCApplyLabelStringXmStringNULLCSG
XmNdialogTypeXmCDialogTypeSelectionTypeNULLCSG
XmNfileListItemsXmCItemsXmStringTableNULLCSG
XmNfileListItemCountXmCItemCountInt-1CSG

XmNdirectory

XmNpattern

XmNdirListLabelString

XmNdirListItems

XmNdirListItemCount

XmNfilterLabelString

XmNdirMask

XmNnoMatchString

XmNqualifySearchDataProc

XmNdirSearchProc

XmNfileSearchProc

XmNfileTypeMask

XmNlistUpdated

XmNdirectoryValid

XmNdirSpec

XmNautoUnmanage

XmNfileListLabelString

XmNapplyLabelString

XmNdialogType

XmNfileListItems

XmNfileListItemCount

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