Scroll to navigation

XmFileSelectionBox(3) LessTif Manuals 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

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

SEE ALSO

<Xm/Xm.h>
April 1998 LessTif Project