9a528400f0
Add directory-only support to Fl_FileBrowser. Update button and menu drawing code for check and radio buttons. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@1582 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
163 lines
4.9 KiB
HTML
163 lines
4.9 KiB
HTML
<HTML>
|
|
<BODY>
|
|
|
|
<!-- NEW PAGE -->
|
|
<H2><A NAME="FL_FileChooser">class Fl_FileChooser</A></H2>
|
|
|
|
<HR>
|
|
|
|
<H3>Class Hierarchy</H3>
|
|
|
|
<UL><PRE>
|
|
<A HREF="Fl_Group.html#Fl_Group">Fl_Group</A>
|
|
|
|
|
+----<B>Fl_FileChooser</B>
|
|
</PRE></UL>
|
|
|
|
<H3>Include Files</H3>
|
|
|
|
<UL><PRE>
|
|
#include <FL/Fl_FileChooser.H>
|
|
</PRE></UL>
|
|
|
|
<H3>Description</H3>
|
|
|
|
<P>The <CODE>Fl_FileChooser</CODE> widget displays a standard file selection
|
|
dialog that supports various selection modes.
|
|
|
|
<CENTER><IMG SRC="Fl_FileChooser.gif" WIDTH="397" HEIGHT="322" ALT="Fl_FileChooser widget"></CENTER>
|
|
|
|
<H3>Methods</H3>
|
|
|
|
<UL>
|
|
|
|
<LI><A HREF="#Fl_FileChooser.Fl_FileChooser">Fl_FileChooser</A>
|
|
<LI><A HREF="#Fl_FileChooser.~Fl_FileChooser">~Fl_FileChooser</A>
|
|
<LI><A HREF="#Fl_FileChooser.color">color</A>
|
|
<LI><A HREF="#Fl_FileChooser.count">count</A>
|
|
<LI><A HREF="#Fl_FileChooser.directory">directory</A>
|
|
<LI><A HREF="#Fl_FileChooser.filter">filter</A>
|
|
<LI><A HREF="#Fl_FileChooser.hide">hide</A>
|
|
<LI><A HREF="#Fl_FileChooser.iconsize">iconsize</A>
|
|
<LI><A HREF="#Fl_FileChooser.label">label</A>
|
|
<LI><A HREF="#Fl_FileChooser.rescan">rescan</A>
|
|
<LI><A HREF="#Fl_FileChooser.show">show</A>
|
|
<LI><A HREF="#Fl_FileChooser.textcolor">textcolor</A>
|
|
<LI><A HREF="#Fl_FileChooser.textfont">textfont</A>
|
|
<LI><A HREF="#Fl_FileChooser.textsize">textsize</A>
|
|
<LI><A HREF="#Fl_FileChooser.type">type</A>
|
|
<LI><A HREF="#Fl_FileChooser.value">value</A>
|
|
<LI><A HREF="#Fl_FileChooser.visible">visible</A>
|
|
|
|
</UL>
|
|
|
|
<H4><A NAME="Fl_FileChooser.Fl_FileChooser">Fl_FileChooser(const char *pathname, const char *pattern,
|
|
int type, const char *title)</A></H4>
|
|
|
|
<P>The constructor creates the <CODE>Fl_FileChooser</CODE> dialog pictured
|
|
above. The <CODE>pathname</CODE> argument can be a directory name or a
|
|
complete file name (in which case the corresponding file is highlighted
|
|
in the list and in the filename input field.)
|
|
|
|
<P>The <CODE>pattern</CODE> argument can be a <CODE>NULL</CODE> string or
|
|
<CODE>"*"</CODE> to list all files. See the FLTK documentation on
|
|
<CODE>filename_match()</CODE> for other kinds of patterns.
|
|
|
|
<P>The <CODE>type</CODE> argument can be one of the following:
|
|
|
|
<UL>
|
|
<LI><CODE>SINGLE</CODE> - allows the user to select a
|
|
single, existing file.
|
|
<LI><CODE>MULTI</CODE> - allows the user to select one
|
|
or more existing files.
|
|
<LI><CODE>CREATE</CODE> - allows the user to select a
|
|
single, existing file or specify a new filename.
|
|
<LI><CODE>DIRECTORY</CODE> - allows the user to select a
|
|
single, existing directory.
|
|
</UL>
|
|
|
|
<P>The <CODE>title</CODE> argument is used to set the title bar text for the
|
|
<CODE>Fl_FileChooser</CODE> window.
|
|
|
|
<H4><A NAME="Fl_FileChooser.~Fl_FileChooser">~Fl_FileChooser()</A></H4>
|
|
|
|
<P>Destroys the widget and frees all memory used by it.
|
|
|
|
<H4><A NAME="Fl_FileChooser.color">void color(Fl_Color c)<BR>
|
|
Fl_Color color()</A></H4>
|
|
|
|
<P>Sets or gets the background color of the <CODE>FileBrowser</CODE> list.
|
|
|
|
<H4><A NAME="Fl_FileChooser.count">int count()</A></H4>
|
|
|
|
<P>Returns the number of selected files.
|
|
|
|
<H4><A NAME="Fl_FileChooser.directory">void directory(const char *pathname)<BR>
|
|
const char *directory()</A></H4>
|
|
|
|
<P>Sets or gets the current directory.
|
|
|
|
<H4><A NAME="Fl_FileChooser.filter">void filter(const char *pattern)<BR>
|
|
const char *filter()</A></H4>
|
|
|
|
<P>Sets or gets the current filename filter pattern.
|
|
|
|
<H4><A NAME="Fl_FileChooser.hide">void hide()</A></H4>
|
|
|
|
<P>Hides the <CODE>Fl_FileChooser</CODE> window.
|
|
|
|
<H4><A NAME="Fl_FileChooser.iconsize">void iconsize(uchar s)<BR>
|
|
uchar iconsize()</A></H4>
|
|
|
|
<P>Sets or gets the size of the icons in the <CODE>FileBrowser</CODE>. By
|
|
default the icon size is set to 1.5 times the <CODE>textsize()</CODE>.
|
|
|
|
<H4><A NAME="Fl_FileChooser.label">void label(const char *l)<BR>
|
|
const char *label()</A></H4>
|
|
|
|
<P>Sets or gets the title bar text for the <CODE>Fl_FileChooser</CODE>.
|
|
|
|
<H4><A NAME="Fl_FileChooser.rescan">void rescan()</A></H4>
|
|
|
|
<P>Reloads the current directory in the <CODE>FileBrowser</CODE>.
|
|
|
|
<H4><A NAME="Fl_FileChooser.show">void show()</A></H4>
|
|
|
|
<P>Shows the <CODE>Fl_FileChooser</CODE> window.
|
|
|
|
<H4><A NAME="Fl_FileChooser.textcolor">void textcolor(Fl_Color c)<BR>
|
|
Fl_Color textcolor()</A></H4>
|
|
|
|
<P>Sets or gets the current <CODE>FileBrowser</CODE> text color.
|
|
|
|
<H4><A NAME="Fl_FileChooser.textfont">void textfont(uchar f)<BR>
|
|
uchar textfont()</A></H4>
|
|
|
|
<P>Sets or gets the current <CODE>FileBrowser</CODE> text font.
|
|
|
|
<H4><A NAME="Fl_FileChooser.textsize">void textsize(uchar s)<BR>
|
|
uchar textsize()</A></H4>
|
|
|
|
<P>Sets or gets the current <CODE>FileBrowser</CODE> text size.
|
|
|
|
<H4><A NAME="Fl_FileChooser.type">void type(int t)<BR>
|
|
int type()</A></H4>
|
|
|
|
<P>Sets or gets the current type of <CODE>Fl_FileChooser</CODE>.
|
|
|
|
<H4><A NAME="Fl_FileChooser.value">const char *value(const char *pathname)<BR>
|
|
const char *value(int file)<BR>
|
|
const char *value()</A></H4>
|
|
|
|
<P>Sets or gets the current value of the selected file.
|
|
|
|
<H4><A NAME="Fl_FileChooser.visible">int visible()</A></H4>
|
|
|
|
<P>Returns 1 if the <CODE>Fl_FileChooser</CODE> window is visible.
|
|
|
|
<HR>
|
|
|
|
|
|
</BODY>
|
|
</HTML>
|