blob: dada482a761d4d345185fef8a510d2947e4e0fb8 (
plain)
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
64
65
66
67
|
=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>,
C<getSaveFile>, and C<chooseDirectory> 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" for choosing existing files to open (default),
"save" for choosing existing or non-existing files to save, or "dir"
for choosing directories.
=item -filter => $glob
A file glob to restrict displayed files. This is only active if no
B<-filetypes> are defined.
=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 <srezic@cpan.org>.
=head1 SEE ALSO
L<Tk::getOpenFile>, L<Tk::IconList>.
|