From 94a9fb879f3bb31785ddca44c6bbaba5283da136 Mon Sep 17 00:00:00 2001
From: Michael R Sweet <michael.r.sweet@gmail.com>
Date: Wed, 1 May 2002 12:41:21 +0000
Subject: Fix backspace "bug" in file chooser - now treat delete and backspace
 the same, eliminating any filename completion value.

Added relative argument to fl_file_chooser() and fl_dir_chooser(); both
default to 0 (return absolute paths)

Give focus to the filename field in the chooser when show() is called.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@2157 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
---
 documentation/functions.html | 46 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

(limited to 'documentation/functions.html')

diff --git a/documentation/functions.html b/documentation/functions.html
index 6dd68e13e..24d42a23d 100644
--- a/documentation/functions.html
+++ b/documentation/functions.html
@@ -17,6 +17,7 @@ A</A>.
 	<LI><A HREF="#fl_choice2"><TT>fl_choice</TT></A></LI>
 	<LI><A HREF="#fl_color_chooser_func"><TT>fl_color_chooser</TT></A></LI>
 	<LI><A HREF="#fl_color_cube"><TT>fl_color_cube</TT></A></LI>
+	<LI><A HREF="#fl_dir_chooser"><TT>fl_dir_chooser</TT></A></LI>
 	<LI><A HREF="#fl_file_chooser2"><TT>fl_file_chooser</TT></A></LI>
 	<LI><A HREF="#fl_file_chooser_callback"><TT>fl_file_chooser_callback</TT></A></LI>
 	<LI><A HREF="#fl_filename_absolute"><TT>fl_filename_absolute</TT></A></LI>
@@ -50,6 +51,7 @@ A</A>.
 		<LI><A HREF="#fl_beep"><TT>fl_beep</TT></A></LI>
 		<LI><A HREF="#fl_choice2"><TT>fl_choice</TT></A></LI>
 		<LI><A HREF="#fl_color_chooser_func"><TT>fl_color_chooser</TT></A></LI>
+		<LI><A HREF="#fl_dir_chooser"><TT>fl_dir_chooser</TT></A></LI>
 		<LI><A HREF="#fl_file_chooser2"><TT>fl_file_chooser</TT></A></LI>
 		<LI><A HREF="#fl_file_chooser_callback"><TT>fl_file_chooser_callback</TT></A></LI>
 		<LI><A HREF="#fl_input2"><TT>fl_input</TT></A></LI>
@@ -326,6 +328,44 @@ fl_color_cube(R * (FL_NUM_RED - 1) / 255,
 </PRE></UL>
 
 
+<!-- NEED 4in -->
+<H2><A NAME="fl_dir_chooser">fl_dir_chooser</A></H2>
+
+<HR>
+
+<H3>Include Files</H3>
+
+<UL><PRE>
+#include &lt;FL/Fl_File_Chooser.H&gt;
+</PRE></UL>
+
+<H3>Prototype</H3>
+
+<UL><PRE>
+char *fl_dir_chooser(const char * message, const char *fname, int relative = 0);
+</PRE></UL>
+
+<H3>Description</H3>
+
+<P>The <tt>fl_dir_chooser()</tt> function displays a <A
+HREF="Fl_File_Chooser.html"><tt>Fl_File_Chooser</tt></A> dialog
+so that the user can choose a directory.
+
+<P><tt>message</tt> is a string used to title the window.
+
+<P><tt>fname</tt> is a default filename to fill in the chooser
+with. If this is <tt>NULL</tt> then the last filename that was
+choosen is used. The first time the file chooser is called this
+defaults to a blank string.
+
+<P><tt>relative</tt> specifies whether the returned filename
+should be relative (any non-zero value) or absolute (0). The
+default is to return absolute paths.
+
+<P>The returned value points at a static buffer that is only
+good until the next time <tt>fl_dir_chooser()</tt> is called.
+
+
 <!-- NEED 4in -->
 <H2><A NAME="fl_file_chooser2">fl_file_chooser</A></H2>
 
@@ -340,7 +380,7 @@ fl_color_cube(R * (FL_NUM_RED - 1) / 255,
 <H3>Prototype</H3>
 
 <UL><PRE>
-char *fl_file_chooser(const char * message, const char *pattern, const char *fname);
+char *fl_file_chooser(const char * message, const char *pattern, const char *fname, int relative = 0);
 </PRE></UL>
 
 <H3>Description</H3>
@@ -371,6 +411,10 @@ choosen is used (unless that had a different pattern, in which
 case just the last directory with no name is used). The first
 time the file chooser is called this defaults to a blank string.
 
+<P><tt>relative</tt> specifies whether the returned filename
+should be relative (any non-zero value) or absolute (0). The
+default is to return absolute paths.
+
 <P>The returned value points at a static buffer that is only
 good until the next time <tt>fl_file_chooser()</tt> is called.
 
-- 
cgit v1.2.3