NAME

SimpleFileSelect -- Easy-to-Use File Selection Widget

SYNOPSIS

use Tk::SimpleFileSelect;

my $fs = $mw -> Tk::SimpleFileSelect();
my $file = $fs -> Show;

Options

-font

Name of the font to display in the directory list and file name entry. The default is '*-helvetica-medium-r-*-*-12-*'.

-width

Width in character columns of the directory listbox. The default is 30.

-height

Height in lines of the directory listbox. The default is 14.

-directory

-initialdir

Path name of initial directory to display. The default is '.' (current directory).

-files

If non-zero, display files as well as directories. The default is 1 (display files).

-acceptlable

Text to display in the 'Accept' button to accept a file or directory selection. Defaults to 'Accept'. The first character is underlined to correspond with an Alt- accelerator constructed with the first letter of the label text.

-initialfile

Text to display initially in the file entry label, and select, if it exists, in the directory Listbox. The default is '' (empty string).

-filter

Display only files matching this pattern. The default is '*' (all files).

DESCRIPTION

Tk::SimpleFileSelect is a easy-to-use file selection widget based on the Tk::FileSelect widget, but returns only a file name. It is the job of the calling program perform any operations on the files named in the SimpleFileSelect's return value.

The Show() method causes the FileSelectWidget to wait until a file is selected in the Listbox or typed in the text entry widget, or the 'Close' button is clicked.

The return value is the pathname of a file selected in the Listbox, or the fully qualified path name of a file given in the text entry, or an empty string if no file name is specified.

VERSION INFORMATION

$Revision: 0.56 $

COPYRIGHT INFO

Tk::SimpleFileSelect is derived from the Tk::FileSelect widget in the Perl/Tk library. It is freely distributable and modifiable under the same conditions as Perl. Please refer to the file "Artistic" in the distribution archive.

Please submit any bugs to the author, rkiesling@mainmatter.com.