Nick Ing-Simmons (PAUSE Custodial Account) > Tk-804.027 > Tk::FBox

Download:
Tk-804.027.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  33
Open  54
Stalled  14
View/Report Bugs
Module Version: 4.018   Source   Latest Release: Tk-804.032_500

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 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" (default) or "save".

-filter => $glob

To be documented...

-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@berlin.de>.

SEE ALSO ^

Tk::getOpenFile, Tk::IconList.

syntax highlighting: