FBox(3pm)						User Contributed Perl Documentation						 FBox(3pm)

NAME

       Tk::FBox - a file dialog

SYNOPSIS

	   use Tk::FBox;
	   $file = $mw->FBox(...)->Show;

DESCRIPTION

       "Tk::FBox" is the dialog implementation behind the "getOpenFile", "getSaveFile", and "chooseDirectory" method calls in the Unix/X11 world.
       As such, it supports all options for these methods and additionally:

       -sortcmd => sub { $_[0] cmp $_[1] }
	   Specified a callback for changing the sorting of the icons in the "IconList" widget. By default, perl's "cmp" operator will be used.

	   From the source code:

	     # Using -sortcmd is really strange :-(
	     # $top->getOpenFile(-sortcmd => sub { package Tk::FBox; uc $b cmp uc $a});
	     # or, un-perlish, but useable (now activated in code):
	     # $top->getOpenFile(-sortcmd => sub { uc $_[1] cmp uc $_[0]});

	   This is an experimental option!

       -type => $type
	   Type should be "open" for choosing existing files to open (default), "save" for choosing existing or non-existing files to save, or
	   "dir" for choosing directories.

       -filter => $glob
	   A file glob to restrict displayed files. This is only active if no -filetypes are defined.

       -force => $bool
	   If true, then there will be no dialog if a file already exists.

COPYRIGHT

       The original tkfbox.tcl from Tcl/Tk is:

       Copyright (c) 1994-1996 Sun Microsystems, Inc.

       See the file "license.terms" for information on usage and redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES.

       Translated to Perl/Tk by Slaven Rezic <srezic@cpan.org>.

SEE ALSO

       Tk::getOpenFile, Tk::IconList.

perl v5.14.2							    2010-05-29								 FBox(3pm)