'\" t.\" $Header: /cvsroot/lesstif/lesstif/doc/lessdox/widgets/XmFileSelectionBox.3,v 1.6 2001/03/04 22:02:02 amai Exp $.\".\" Copyright (C) 1997-1998 Free Software Foundation, Inc..\" .\" This file is part of the GNU LessTif Library..\" This library is free software; you can redistribute it and/or.\" modify it under the terms of the GNU Library General Public.\" License as published by the Free Software Foundation; either.\" version 2 of the License, or (at your option) any later version..\" .\" This library is distributed in the hope that it will be useful,.\" but WITHOUT ANY WARRANTY; without even the implied warranty of.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU.\" Library General Public License for more details..\" .\" You should have received a copy of the GNU Library General Public.\" License along with this library; if not, write to the Free.\" Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA..\" .TH XmFileSelectionBox 3 "April 1998" "LessTif Project" "LessTif Manuals".SH NAMEXmFileSelectionBox.SH SYNOPSIS.B #include <Xm/FileSB.h>.PP.B XmFileSelectionBox.PP.B XmCreateFileSelectionBox.SH DESCRIPTIONXmFileSelectionBox.SH X RESOURCES.TStab(;);l l l l l.Name;Class;Type;Default;Access_XmNdirectory;XmCDirectory;XmString;NULL;CSGXmNpattern;XmCPattern;XmString;NULL;CSGXmNdirListLabelString;XmCDirListLabelString;XmString;NULL;CSGXmNdirListItems;XmCDirListItems;XmStringTable;NULL;CSGXmNdirListItemCount;XmCDirListItemCount;Int;-1;CSGXmNfilterLabelString;XmCFilterLabelString;XmString;NULL;CSGXmNdirMask;XmCDirMask;XmString;NULL;CSGXmNnoMatchString;XmCNoMatchString;XmString;NULL;CSGXmNqualifySearchDataProc;XmCQualifySearchDataProc;Proc;NULL;CSGXmNdirSearchProc;XmCDirSearchProc;Proc;NULL;CSGXmNfileSearchProc;XmCFileSearchProc;Proc;NULL;CSGXmNfileTypeMask;XmCFileTypeMask;FileTypeMask;NULL;CSGXmNlistUpdated;XmCListUpdated;Boolean;NULL;CSGXmNdirectoryValid;XmCDirectoryValid;Boolean;NULL;CSGXmNdirSpec;XmCDirSpec;XmString;NULL;CSGXmNautoUnmanage;XmCAutoUnmanage;Boolean;NULL;CSGXmNfileListLabelString;XmCFileListLabelString;XmString;NULL;CSGXmNapplyLabelString;XmCApplyLabelString;XmString;NULL;CSGXmNdialogType;XmCDialogType;SelectionType;NULL;CSGXmNfileListItems;XmCItems;XmStringTable;NULL;CSGXmNfileListItemCount;XmCItemCount;Int;-1;CSG.TE.PP.BR XmNdirectory.PP.BR XmNpattern.PP.BR XmNdirListLabelString.PP.BR XmNdirListItems.PP.BR XmNdirListItemCount.PP.BR XmNfilterLabelString.PP.BR XmNdirMask.PP.BR XmNnoMatchString.PP.BR XmNqualifySearchDataProc.PP.BR XmNdirSearchProc.PP.BR XmNfileSearchProc.PP.BR XmNfileTypeMask.PP.BR XmNlistUpdated.PP.BR XmNdirectoryValid.PP.BR XmNdirSpec.PP.BR XmNautoUnmanage.PP.BR XmNfileListLabelString.PP.BR XmNapplyLabelString.PP.BR XmNdialogType.PP.BR XmNfileListItems.PP.BR XmNfileListItemCount.PP.SH CLASS HIERARCHY.BR Object (3).BR Rect (3).BR UnNamedObj (3).BR Core (3).BR Composite (3).BR Constraint (3).BR XmManager (3).BR XmBulletinBoard (3).BR XmSelectionBox (3).BR XmFileSelectionBox (3).SH CALLBACKS.BR XmFileSelectionBoxhas several callback lists,all of which are inherited from the superclass XmSelectionBox :.BR XmNokCallback ,.BR XmNcancelCallback ,.BR XmNhelpCallback ,.BR XmNfilterCallback .In all these cases, the call_data parameter passed is of typeXmFileSelectionBoxCallbackStruct :.br.SM  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;.SM.PPThe reason field can have the valuesXmCR_OK, XmCR_NO_MATCH, XmCR_CANCEL, XmCR_HELP.The event field contains a pointer to the information from Xlib from theevent that triggered this callback..PPThe other fields ....SH SEARCH PROCEDURESXmFileSelectionBox also has a number of resources which allow you to specifya (usually) system dependent function that helps it in traversing thefilesystem.These are not callback lists as implemented in the Intrinsics;they can call one function with specific behaviour.They are : XmNqualifySearchDataProc, XmNdirSearchProc, XmNfileSearchProc..PPXmNqualifySearchDataProc is called when ....PPXmNdirSearchProc is called when ....PPXmNfileSearchProc is called when ....SH CONVENIENCE FUNCTIONS.SH SEE ALSO<Xm/Xm.h>