1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172
|
<HTML>
<HEAD>
<TITLE>FileChooser - ESP Widget Set for FLTK</TITLE>
<LINK REL="STYLESHEET" TYPE="text/css" HREF="fltk.css">
<MAP NAME="navbar">
<AREA SHAPE="RECT" COORD="20,19,74,36" HREF="index.html" ALT="Widget Set Home Page">
<AREA SHAPE="RECT" COORD="96,19,240,36" HREF="documentation.html" ALT="Widget Set Documentation">
<AREA SHAPE="RECT" COORD="262,19,356,36" HREF="download.html" ALT="Download Widget Set">
<AREA SHAPE="RECT" COORD="378,19,416,36" HREF="http://www.easysw.com" ALT="ESP Home Page">
<AREA SHAPE="RECT" COORD="438,19,487,36" HREF="http://www.fltk.org" ALT="FLTK Home Page">
</MAP>
</HEAD>
<BODY BGCOLOR="#ccccff">
<!-- NEW PAGE -->
<H2>class FileChooser</H2>
<HR>
<H3>Class Hierarchy</H3>
<UL><PRE>
Fl_Group
|
+----<B>FileChooser</B>
</PRE></UL>
<H3>Include Files</H3>
<UL><PRE>
#include "FileChooser.h"
</PRE></UL>
<H3>Description</H3>
<P>The <CODE>FileChooser</CODE> widget displays a standard file selection
dialog that supports various selection modes.
<CENTER><IMG SRC="FileChooser.gif" WIDTH="397" HEIGHT="322" ALT="FileChooser widget"></CENTER>
<H3>Methods</H3>
<UL>
<LI><A HREF="#FileChooser.FileChooser">FileChooser</A>
<LI><A HREF="#FileChooser.~FileChooser">~FileChooser</A>
<LI><A HREF="#FileChooser.color">color</A>
<LI><A HREF="#FileChooser.count">count</A>
<LI><A HREF="#FileChooser.directory">directory</A>
<LI><A HREF="#FileChooser.filter">filter</A>
<LI><A HREF="#FileChooser.hide">hide</A>
<LI><A HREF="#FileChooser.iconsize">iconsize</A>
<LI><A HREF="#FileChooser.label">label</A>
<LI><A HREF="#FileChooser.rescan">rescan</A>
<LI><A HREF="#FileChooser.show">show</A>
<LI><A HREF="#FileChooser.textcolor">textcolor</A>
<LI><A HREF="#FileChooser.textfont">textfont</A>
<LI><A HREF="#FileChooser.textsize">textsize</A>
<LI><A HREF="#FileChooser.type">type</A>
<LI><A HREF="#FileChooser.value">value</A>
<LI><A HREF="#FileChooser.visible">visible</A>
</UL>
<H4><A NAME="FileChooser.FileChooser">FileChooser(const char *pathname, const char *pattern,
int type, const char *title)</A></H4>
<P>The constructor creates the <CODE>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.
</UL>
<P>The <CODE>title</CODE> argument is used to set the title bar text for the
<CODE>FileChooser</CODE> window.
<H4><A NAME="FileChooser.~FileChooser">~FileChooser()</A></H4>
<P>Destroys the widget and frees all memory used by it.
<H4><A NAME="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="FileChooser.count">int count()</A></H4>
<P>Returns the number of selected files.
<H4><A NAME="FileChooser.directory">void directory(const char *pathname)<BR>
const char *directory()</A></H4>
<P>Sets or gets the current directory.
<H4><A NAME="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="FileChooser.hide">void hide()</A></H4>
<P>Hides the <CODE>FileChooser</CODE> window.
<H4><A NAME="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="FileChooser.label">void label(const char *l)<BR>
const char *label()</A></H4>
<P>Sets or gets the title bar text for the <CODE>FileChooser</CODE>.
<H4><A NAME="FileChooser.rescan">void rescan()</A></H4>
<P>Reloads the current directory in the <CODE>FileBrowser</CODE>.
<H4><A NAME="FileChooser.show">void show()</A></H4>
<P>Shows the <CODE>FileChooser</CODE> window.
<H4><A NAME="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="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="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="FileChooser.type">void type(int t)<BR>
int type()</A></H4>
<P>Sets or gets the current type of <CODE>FileChooser</CODE>.
<H4><A NAME="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="FileChooser.visible">int visible()</A></H4>
<P>Returns 1 if the <CODE>FileChooser</CODE> window is visible.
<HR>
</BODY>
</HTML>
|