FBox
Section: User Contributed Perl Documentation (3)
Updated: 2021-01-27
Page Index
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.