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
|
=head1 NAME
Tk::FBox - a file dialog
=for pm Tk/FBox.pm
=for category Popups and Dialogs
=head1 SYNOPSIS
use Tk::FBox;
$file = $mw->FBox(...)->Show;
=head1 DESCRIPTION
C<Tk::FBox> is the dialog implementation behind the C<getOpenFile> and
C<getSaveFile> method calls in the Unix/X11 world. As such, it
supports all options for these methods and additionally:
=over
=item -sortcmd => sub { $_[0] cmp $_[1] }
Specified a callback for changing the sorting of the icons in the
C<IconList> widget. By default, perl's C<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!
=item -type => $type
Type should be "open" (default) or "save".
=item -filter => $glob
To be documented...
=item -force => $bool
If true, then there will be no dialog if a file already exists.
=back
=head1 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@berlin.de>.
=head1 SEE ALSO
Tk::getOpenFile, Tk::IconList.
|