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

Object(3) Rect(3) UnNamedObj(3) Core(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