From 861ad9769b94f52e3528817c8654c572d98ce760 Mon Sep 17 00:00:00 2001 From: Michael R Sweet Date: Fri, 7 Jun 2002 15:06:32 +0000 Subject: New file chooser. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@2286 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- documentation/Fl_File_Chooser.html | 104 ++++++++++++++++++++++++++----------- 1 file changed, 74 insertions(+), 30 deletions(-) (limited to 'documentation/Fl_File_Chooser.html') diff --git a/documentation/Fl_File_Chooser.html b/documentation/Fl_File_Chooser.html index c349ea5bd..b25d40870 100644 --- a/documentation/Fl_File_Chooser.html +++ b/documentation/Fl_File_Chooser.html @@ -25,35 +25,62 @@

The Fl_File_Chooser widget displays a standard file selection dialog that supports various selection modes. -

Fl_File_Chooser widget
+
Fl_File_Chooser widget

The Fl_File_Chooser class also exports several static values that may be used to localize or customize the appearance of all file chooser dialogs: -

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
MemberDefault value
add_favorites_label"Add to Favorites"
all_files_label"All Files (*)"
existing_file_label"Please choose an existing file!"
favorites_label"Favorites"
filename_label"Filename:"
filesystems_label"My Computer" (WIN32)
+ "File Systems" (all others)
manage_favorites_label"Manage Favorites"
preview_label"Preview"
show_label"Show:"
sortfl_numericsort
+ +

The sort member specifies the sort function that is +used when loading the contents of a directory.

Methods

@@ -68,6 +95,7 @@ dialogs:
  • hide
  • iconsize
  • label +
  • preview
  • rescan
  • show
  • textcolor @@ -88,10 +116,23 @@ complete file name (in which case the corresponding file is highlighted in the list and in the filename input field.)

    The pattern argument can be a NULL -string or "*" to list all files. See the FLTK -documentation on "*" to list all files, or it can be a +series of descriptions and filter strings separated by tab +characters (\t). The format of filters is either +"Description text (patterns)" or just "patterns". A file chooser +that provides filters for HTML and image files might look like: + +

    + +

    The file chooser will automatically add the "All Files (*)" +pattern to the end of the string you pass if you do not provide +one. The first filter in the string is the default filter. + +

    See the FLTK documentation on fl_filename_match() -for other kinds of patterns. +for the kinds of pattern strings that are supported.

    The type argument can be one of the following: @@ -147,6 +188,12 @@ const char *label()

    Sets or gets the title bar text for the Fl_File_Chooser. +

    void preview(int e)
    +int preview()

    + +

    The first form enables or disables the preview box in the file chooser. +The second form returns the current state of the preview box. +

    void rescan()

    Reloads the current directory in the Fl_File_Browser. @@ -185,8 +232,5 @@ const char *value()

    Returns 1 if the Fl_File_Chooser window is visible. -

    - - -- cgit v1.2.3