Added Fl_Native_File_Chooser widget (with manolo's cocoa mods) to FLTK.

	* Source brought into CMP standards compliance
	* test program added (test/native-filechooser.cxx)
	* Tested with linux (Ubuntu8) and with OSX (cocoa and non-cocoa builds)

TODO:
	* Needs doxygen docs from Greg's original HTML documentation
	* Needs mods to Windows build files
	* Needs mods to cmake, and other build files
	* Needs Manolo's latest mods (from STR #2298) mentioned on and after "02:05 Jan 13, 2010"



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6997 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

4 files changed, 420 insertions, 0 deletions

diff --git a/FL/Fl_Native_File_Chooser.H b/FL/Fl_Native_File_Chooser.H
new file mode 100644
index 000000000..77b10dbd0
--- /dev/null
+++ b/FL/Fl_Native_File_Chooser.H
@@ -0,0 +1,47 @@
+//
+// "$Id$"
+//
+// FLTK native OS file chooser widget
+//
+// Copyright 1998-2009 by Bill Spitzak and others.
+// Copyright 2004 Greg Ercolano.
+//
+// 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+// USA.
+//
+// Please report all bugs and problems on the following page:
+//
+//     http://www.fltk.org/str.php
+//
+
+#ifndef FL_NATIVE_FILE_CHOOSER_H
+#define FL_NATIVE_FILE_CHOOSER_H
+
+// Use Windows' chooser
+#ifdef _WIN32
+#include <FL/Fl_Native_File_Chooser_WIN32.H>
+#endif
+
+// Use Apple's chooser
+#ifdef __APPLE__
+#include <FL/Fl_Native_File_Chooser_MAC.H>
+#endif
+
+// All else falls back to FLTK's own chooser
+#if ! defined(__APPLE__) && !defined(_WIN32)
+#include <FL/Fl_Native_File_Chooser_FLTK.H>
+#endif
+
+#endif /*FL_NATIVE_FILE_CHOOSER_H*/
diff --git a/FL/Fl_Native_File_Chooser_FLTK.H b/FL/Fl_Native_File_Chooser_FLTK.H
new file mode 100644
index 000000000..afc671048
--- /dev/null
+++ b/FL/Fl_Native_File_Chooser_FLTK.H
@@ -0,0 +1,111 @@
+//
+// "$Id$"
+//
+// FLTK native OS file chooser widget
+//
+// Copyright 1998-2009 by Bill Spitzak and others.
+// Copyright 2005 by Nathan Vander Wilt.
+//
+// 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+// USA.
+//
+// Please report all bugs and problems on the following page:
+//
+//     http://www.fltk.org/str.php
+//
+
+#include <FL/Fl_File_Chooser.H>
+#include <string.h>
+
+class Fl_Native_File_Chooser {
+public:
+  enum Type {
+    BROWSE_FILE = 0,
+    BROWSE_DIRECTORY,
+    BROWSE_MULTI_FILE,
+    BROWSE_MULTI_DIRECTORY,
+    BROWSE_SAVE_FILE,
+    BROWSE_SAVE_DIRECTORY
+  };
+  enum Option {
+    NO_OPTIONS     = 0x0000,	// no options enabled
+    SAVEAS_CONFIRM = 0x0001,	// Show native 'Save As' overwrite confirm dialog (if supported)
+    NEW_FOLDER     = 0x0002,	// Show 'New Folder' icon (if supported)
+    PREVIEW        = 0x0004	// enable preview mode
+  };
+private:
+  int   _btype;			// kind-of browser to show()
+  int   _options;		// general options
+  char *_filter;		// user supplied filter
+  char *_parsedfilt;		// parsed filter
+  int   _filtvalue;		// selected filter
+  char *_preset_file;
+  char *_prevvalue;		// Returned filename
+  char *_directory;
+  char *_errmsg;		// error message
+  Fl_File_Chooser *file_chooser;
+
+  int exist_dialog() {
+    return(fl_choice("File exists. Are you sure you want to overwrite?", 
+		     "Cancel", "   OK   ", NULL));
+  }
+  void load_system_icons() {
+    Fl_File_Icon::load_system_icons();
+  }
+
+  int _nfilters;
+
+  //added by MG
+  Fl_File_Browser *my_fileList;
+  Fl_Check_Button *show_hidden;
+  char old_dir[300];
+  int prev_filtervalue;
+  static void show_hidden_cb(Fl_Check_Button *o, void *data);
+  static void remove_hidden_files(Fl_File_Browser *my_fileList);
+
+  // Private methods
+  void errmsg(const char *msg);
+  int type_fl_file(int);
+  void parse_filter();
+  void keeplocation();
+
+public:
+  Fl_Native_File_Chooser(int val=BROWSE_FILE);
+  ~Fl_Native_File_Chooser();
+
+  // Public methods
+  void type(int);
+  int type() const;
+  void options(int);
+  int options() const;
+  int count() const;
+  const char *filename() const;
+  const char *filename(int i) const;
+  void directory(const char *val);
+  const char *directory() const;
+  void title(const char *);
+  const char* title() const;
+  const char *filter() const;
+  void filter(const char *);
+  int filters() const { return(_nfilters); }
+  void filter_value(int i);
+  int filter_value() const;
+  void preset_file(const char*);
+  const char* preset_file() const;
+  const char *errmsg() const;
+  int show();
+  // added by MG
+  Fl_Choice *showChoice;
+};
diff --git a/FL/Fl_Native_File_Chooser_MAC.H b/FL/Fl_Native_File_Chooser_MAC.H
new file mode 100644
index 000000000..c65e8909e
--- /dev/null
+++ b/FL/Fl_Native_File_Chooser_MAC.H
@@ -0,0 +1,156 @@
+//
+// "$Id$"
+//
+// FLTK native OS file chooser widget
+//
+// Copyright 1998-2009 by Bill Spitzak and others.
+// Copyright 2004 Greg Ercolano.
+//
+// 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+// USA.
+//
+// Please report all bugs and problems on the following page:
+//
+//     http://www.fltk.org/str.php
+//
+
+// OSX-SPECIFIC NATIVE BROWSER
+#ifdef __APPLE_CC__
+#include <Carbon/Carbon.h>
+#else /*__APPLE_CC__*/
+#include <Carbon.h>
+#endif /*__APPLE_CC__*/
+#include <config.h>
+
+#undef check // necessary for use of Fl::check()
+
+#include <FL/filename.H>
+#define MAXFILTERS	80
+
+class Fl_Native_File_Chooser {
+public:
+  enum Type {
+    BROWSE_FILE = 0,
+    BROWSE_DIRECTORY,
+    BROWSE_MULTI_FILE,
+    BROWSE_MULTI_DIRECTORY,
+    BROWSE_SAVE_FILE,
+    BROWSE_SAVE_DIRECTORY
+  };
+  enum Option {
+    NO_OPTIONS     = 0x0000,		// no options enabled
+    SAVEAS_CONFIRM = 0x0001,		// Show native 'Save As' overwrite confirm dialog (if supported)
+    NEW_FOLDER     = 0x0002,		// Show 'New Folder' icon (if supported)
+    PREVIEW        = 0x0004,		// enable preview mode
+  };
+#ifndef __APPLE_COCOA__
+protected:
+  NavDialogCreationOptions _opts;	// file navigation options
+#endif
+private:
+  int             _btype;		// kind-of browser to show()
+  int             _options;		// general options
+#ifdef __APPLE_COCOA__
+  void 	         *_panel;
+#else
+  NavDialogRef    _ref;		        // file navigation reference
+#endif
+  NavActionState  _keepstate;		// holds button permissions
+  NavMenuItemSpec _tempitem;   	        // Popup menu selection
+  char          **_pathnames;		// array of pathnames
+  int             _tpathnames;	        // total pathnames
+  char           *_directory;		// default pathname to use
+  char           *_title;		// title for window
+  char           *_preset_file;	        // the 'save as' filename
+
+  char           *_filter;		// user-side search filter, eg:
+					// C Files\t*.[ch]\nText Files\t*.txt"
+
+  char           *_filt_names;		// filter names (tab delimited)
+					// eg. "C Files\tText Files"
+
+  char           *_filt_patt[MAXFILTERS];
+					// array of filter patterns, eg:
+					//     _filt_patt[0]="*.{cxx,h}"
+					//     _filt_patt[1]="*.txt"
+
+  int             _filt_total;		// parse_filter() # of filters loaded
+  int             _filt_value;		// index of the selected filter
+  char           *_errmsg;		// error message
+
+#ifndef __APPLE_COCOA__
+  // PRIVATE CLASS TO HANDLE NAVIGATION DIALOG REPLY STRUCT
+  //     Class-ified, mainly to ensure proper cleanup.
+  //
+  class NavReply {
+    int _valid_reply;
+    NavReplyRecord _reply;
+  public:
+    NavReply();
+    ~NavReply();
+    int get_reply(NavDialogRef& ref);
+    int get_saveas_basename(char *s, int slen);
+    int get_dirname(char *s, int slen);
+    int get_pathnames(char **&pathnames, int& tpathnames);
+  };
+#endif
+  // Private methods
+  void errmsg(const char *msg);
+  void clear_pathnames();
+  void set_single_pathname(const char *s);
+#ifdef __APPLE_COCOA__
+  int get_saveas_basename(void);
+#else
+  int get_saveas_basename(NavDialogRef& ref);
+#endif
+  int get_pathnames(NavDialogRef& ref);
+  static void event_handler(NavEventCallbackMessage callBackSelector, 
+			    NavCBRecPtr cbparm, void *data);
+
+  void clear_filters();
+  void add_filter(const char *, const char *);
+  void parse_filter(const char *from);
+#ifndef __APPLE_COCOA__
+  static Boolean filter_proc_cb(AEDesc *, void *, void *, NavFilterModes);
+  Boolean filter_proc_cb2(AEDesc*, void*, void*, NavFilterModes);
+#endif
+  int post();
+
+public:
+  Fl_Native_File_Chooser(int val = BROWSE_FILE);
+  ~Fl_Native_File_Chooser();
+
+  // Public methods
+  void type(int);
+  int type() const;
+  void options(int);
+  int options() const;
+  int count() const;
+  const char *filename() const;
+  const char *filename(int i) const;
+  void directory(const char *);
+  const char *directory() const;
+  void title(const char *);
+  const char *title() const;
+  const char *filter() const;
+  void filter(const char *);
+  void filter_value(int i) { _filt_value = i; }
+  int filter_value() { return(_filt_value); }
+  int filters() { return(_filt_total); }
+  void preset_file(const char *);
+  const char *preset_file();
+  const char *errmsg() const;
+  int show();
+};
diff --git a/FL/Fl_Native_File_Chooser_WIN32.H b/FL/Fl_Native_File_Chooser_WIN32.H
new file mode 100644
index 000000000..6429e461c
--- /dev/null
+++ b/FL/Fl_Native_File_Chooser_WIN32.H
@@ -0,0 +1,106 @@
+//
+// Fl_Native_File_Chooser_WINDOWS.H -- FLTK native OS file chooser widget
+//
+// Copyright 2004 by Greg Ercolano.
+// April 2005 - API changes, improved filter processing by Nathan Vander Wilt
+//
+// 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+// USA.
+//
+
+// #define _WIN32_WINNT	0x0501	// needed for OPENFILENAME's 'FlagsEx'
+#include <stdio.h>
+#include <stdlib.h>		// malloc
+#include <windows.h>
+#include <commdlg.h>		// OPENFILENAME, GetOpenFileName()
+#include <shlobj.h>		// BROWSEINFO, SHBrowseForFolder()
+
+class Fl_Native_File_Chooser {
+public:
+  enum Type {
+    BROWSE_FILE = 0,
+    BROWSE_DIRECTORY,
+    BROWSE_MULTI_FILE,
+    BROWSE_MULTI_DIRECTORY,
+    BROWSE_SAVE_FILE,
+    BROWSE_SAVE_DIRECTORY
+  };
+  enum Option {
+    NO_OPTIONS     = 0x0000,	// no options enabled
+    SAVEAS_CONFIRM = 0x0001,	// Show native 'Save As' overwrite confirm dialog (if supported)
+    NEW_FOLDER     = 0x0002,	// Show 'New Folder' icon (if supported)
+    PREVIEW        = 0x0004,	// enable preview mode
+  };
+private:
+  int  _btype;			// kind-of browser to show()
+  int  _options;		// general options
+  OPENFILENAMEW _ofn;		// GetOpenFileName() & GetSaveFileName() struct
+  BROWSEINFO   _binf;		// SHBrowseForFolder() struct
+  char  **_pathnames;		// array of pathnames
+  int     _tpathnames;		// total pathnames
+  char   *_directory;		// default pathname to use
+  char   *_title;		// title for window
+  char   *_filter;		// user-side search filter
+  char   *_parsedfilt;		// filter parsed for Windows dialog
+  int     _nfilters;		// number of filters parse_filter counted
+  char   *_preset_file;		// the file to preselect
+  char   *_errmsg;		// error message
+
+  // Private methods
+  void errmsg(const char *msg);
+
+  void clear_pathnames();
+  void set_single_pathname(const char *s);
+  void add_pathname(const char *s);
+
+  void FreePIDL(ITEMIDLIST *pidl);
+  void ClearOFN();
+  void ClearBINF();
+  void Win2Unix(char *s);
+  void Unix2Win(char *s);
+  int showfile();
+  static int CALLBACK Dir_CB(HWND win, UINT msg, LPARAM param, LPARAM data);
+  int showdir();
+
+  void parse_filter(const char *);
+  void clear_filters();
+  void add_filter(const char *, const char *);
+
+public:
+  Fl_Native_File_Chooser(int val = BROWSE_FILE);
+  ~Fl_Native_File_Chooser();
+
+  // Public methods
+  void type(int val);
+  int type() const;
+  void options(int);
+  int options() const;
+  int count() const;
+  const char *filename() const;
+  const char *filename(int i) const;
+  void directory(const char *val);
+  const char *directory() const;
+  void title(const char *val);
+  const char *title() const;
+  const char *filter() const;
+  void filter(const char *val);
+  int filters() const { return _nfilters; }
+  void filter_value(int i);
+  int filter_value() const;
+  void preset_file(const char *);
+  const char *preset_file() const;
+  const char *errmsg() const;
+  int show();
+};