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).

-dotfiles

If non-zero, display normally hidden files that begin with '.'. The default is 0 (don't display hidden files).

-acceptlabel

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.

-filter

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

-initialtext

The text to appear in the entry box when the widget is opened.

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.

Clicking in the list box on a file or directory name selects it and inserts the selected item in the entry box. Double clicking on a directory or entering it in the entry box changes to that directory.

The Show() method causes the FileSelectWidget to wait until a file is selected in the Listbox, a file name is entered 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.

ADVERTISED SUBWIDGETS

None.

VERSION INFORMATION

  $Id: SimpleFileSelect.pm,v 0.65 2002/03/24 21:34:56 kiesling Exp $

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.