NAME
Tk::FBox - a file dialog
SYNOPSIS
use Tk::FBox;
$file = $mw->FBox(...)->Show;DESCRIPTION
Tk::FBox is the dialog implementation behind the getOpenFile and getSaveFile 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
IconListwidget. By default, perl'scmpoperator 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 and subject to change.
- -type => $type
-
Type should be "open" (default) or "save".
- -filter => $val
-
A filter to restrict the directories and files in the icon list. If specified as a glob pattern, then only files will be filtered by the pattern. If specified as a subroutine, then this subroutine will be called for every file and directory and should return a true value, if the argument should be accepted for the icon list. The arguments of this subroutine are: FBox widget reference, basename of file, and directory name.
The subroutine form of this option is experimental.
- -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 <slaven@rezic.de>.
SEE ALSO
Tk::getOpenFile, Tk::IconList.