---
name: "Tk::FBox"
section: "3pm"
platform: "linux"
package: "perl-tk"
version: "804.036-9"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Tk::FBox"
---

# Tk::FBox(3pm)

a file dialog

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