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

1 files changed, 156 insertions, 0 deletions

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();
+};