#include <FL/Fl_File_Dialog.H>
int  fl_file_dialog(const char* title, char* pathAndFile,  int sortType=0, int filterType=0,int Mode);

• title - title of Dialog ie. Save/Open.
• pathAndFile - is a supplied pointer to a string with enough space [FL_MAX_DIR] to hold the returned filename and path, the string can contain the desired startup directory as well as the patten to match. eg. /foo/f*.text, C:\test\t*.exe (if pattern exists it will be added to pattern menu)
• sortType - startup sort to use NOTE: if the sort type is not alpha based ,the fstat needs to be called and will not be as fast.
• filterType - startup filter type to useis used to limit the files listed in a directory to those matching the pattern
• Mode - this is if you wish the user to have Single or Multi mode for there selection . Multi Mode will list files seperated by a comma. An Icon will appear in each of the different modes.

Directory Bar (Slash Bar)
This will maintain a division at each directory, pressing the button before will change the directory to the location represented by the division

Quick Fix Menu (Right Mouse in input Field)
This will present a list of quick directory locations

Quick Fix Defaults
Fl_Menu pulldown[] = {
  {"Up directory",     0},
  {"Root directory",   0},
  {"Home directory",   0},
... (rest are for stack of last accessed directories)

SortType  (will slow to do fstat call if  sort is not alpha/numeric)

FilterType - (will slow to do fstat call first if a filterType is set)

 Default Patterns

• * matches any sequence of 0 or more characters.
• ? matches any single character.
• [set] matches any character in the set. Set can contain any single characters, or a-z to represent a range. To match ] or - they must be the first  characters. To match ^ or ! they must not be the first characters.
• [^set] or [!set] matches any character not in the set.
• {X|Y|Z} or {X,Y,Z} matches any one of the subexpressions literally.
• \x quotes the character x so it has no special meaning.
• x all other characters must be matched exactly.

   char selection[FL_MAX_PATH];
   int slash;
   strcpy(selection, "*.*");   //setlocation and/or path
   slash = fl_file_dialog("Open File",selection,0,0,1);
   if(slash) fl_message((char*)(selection+slash));           //the slash is 0 if nothing selected else it will be the length to the slash
 

Fl_File_Input

This also contains the Quick Fix menus
"Up directory"
"Root directory"
"Home directory"
"Current directory"
 

Fl_Dir

Fl_Dir( char *pathAndFile, int sortType = FL_SORT_NAME, int filterType = 0 );

int Fl_Input_File::getFilename(char *out)
fillin out(path+file),return 0 if invalid selection else length to last slash

int Fl_Input_File::setFilename(char *in)
Use the input string to change directory and update input cd(string)
 
 Fl_Dir_File *fileList()
return list of file entries (resets when reached nDirFiles total)

Fl_Dir_File *fileListReset()
force the reset for the fileList
 
in Fl_Dir_File *fileListSet(int num){ dirListCount=num; return NULL;}
set the list to a number(ie..tracking progress)

 Fl_Dir_File *fileInList(char *file,int filteronoff=1)
check if file is currently shown in dir List,use Spec&filter TRUE/FALSE;

int  dirSort(int type)
main function to do sorting
 int  dirSetSort(int type)
set the sort type
 int  dirSetFilter(int flags)
set the Filter type
int  dirToggelFilter(int flags)
toggle the current flag Filter  ON/OFF
int  dirIsFilter(int flags)
 return if Filter flag is set
 int  dirSetDisplay(char *dir);
 set the display flag for files maching pattern
 void dirHaltScan()
 request that the scan be stopped,done by GUI
void dirResetScan()
 reset the scan to start from start.

void  dir_callback1(Dir_Callback* c=NULL, void* p=0)
callback when directory changed and needs refresh

dir_callback_error_(this,dir_user_data_error_);}
error ,callback when error condition

cd(const char *buf);
 set the directory to this if needed
 int  cdUp();
 change up one directory
 int  cdRoot();
 goto root directory or NT C:
 int  cdHome();
 look for env HOME and change if exists
 int  cdCurrent();
 change to current directory
int cdSub(char *);
change to a subdirectory, off the current directory (dont need full path) you can scan if a directory/File exist's and change into it (sub) or process it (file). changing up or down the directory tree.  eg. cdSub("home");  if the user is in the root directory, it will try "/home"

 int  tabComplete(const char *dir,char *buf);
  try to do tab complete on the dir list
 int  lenSlashPattern(char *ch,int &slash=tmpInt,int &hasPattern=tmpInt,int &prevSlash=tmpInt);
 this function returns the length of str,slash,pattern,and prev slash (very usefull)
 int  simpleExp( const char *s, const char *e, int CaseSens = TRUE );
 Test for the pattern matching
int  filename_expand(char *t,const char *f)
 check for ~,$HOME etc..

 see FL_File_Dialog example

Fl_Pack

This widget was designed to add the functionality of compressing and aligning widgets. It is now included in the main Fltk Library and should be referenced there.

Fl_Pix_Box

Fl_Pix_Box(int x,int y,int w,int h,const char *l = 0,Fl_Pixmap* bUp=0);
The main use of the Fl_Pix_Box is to place a PIX in the box ,TILING the pix and cropping if the box size is bigger or smaller
see PIX_BUTTON example.

Fl_Pix_Button

Fl_Pix_Button(int x,int y,int w,int h,const char *l = 0,Fl_Pixmap* bUp=0,Fl_Pixmap* bDown=0,Fl_Pixmap* bHilight=0);

Fl_Frametab

Fl_Frametab(int x,int y,int w,int h, char *fname)

Drop down Tab style group widget, can contain other widgets.
 

Changes up to 1.3

FileDialog/File_Input/FL_Dir