Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

Tk::FBox (3)

Name

Tk::FBox - a file dialog

Synopsis

use Tk::FBox;
$file = $mw->FBox(...)->Show;

Description

User Contributed Perl Documentation                                    FBox(3)



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>.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+----------------------------+
       |ATTRIBUTE TYPE |      ATTRIBUTE VALUE       |
       +---------------+----------------------------+
       |Availability   | library/perl-5/perl-tk-532 |
       +---------------+----------------------------+
       |Stability      | Volatile                   |
       +---------------+----------------------------+

SEE ALSO
       Tk::getOpenFile, Tk::IconList.



NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://search.cpan.org/CPAN/authors/id/S/SR/SREZIC/Tk-804.036.tar.gz.

       Further information about this software can be found on the open source
       community website at http://search.cpan.org/~srezic/Tk.



perl v5.32.0                      2013-11-15                           FBox(3)