fsdialog(3tcl)

🌸 fsdialog — the manual, bestie edition 💅

okay so this is fsdialog(3tcl), aka the File system dialog boxes page, and it's genuinely iconic. it's a Tcl/Tk package that gives you fancy file-picking dialogs, and i'm about to walk you through every single detail like we're texting at 2am. 🦋

---

✨ NAME ✨

fsdialog — dialog boxes for the user to select a file or directory. that's it, that's the vibe. you want a file? a folder? she's got you. 💖

---

✨ SYNOPSIS ✨

package require Tk  8.6.6

package require fsdialog  1.0

ttk::fsdialog configfile ?name?

ttk::fsdialog history ?name ...?

ttk::fsdialog preferences ?option? ?value option value ...?

like, look at her. three little commands and a whole world of file-picking power. no cap. 🔥

---

✨ DESCRIPTION ✨

so here's the tea, bestie: the fsdialog package installs direct replacements for the original tk_getOpenFile, tk_getSaveFile, and tk_chooseDirectory commands of Tk. same names, same energy, but these replacements come with more advanced features for user interaction. glow-up of the century honestly. 👑

if you wanna know the fine print of how the originals work — the usage details, the argument lore — go read the manual pages of those original commands. this page is about the extras.

and to control all those advanced features, the package hands you some additional commands. let's get into them one by one, periodt. 🎀

🌟 ttk::fsdialog configfile ?name?

Specify a configuration file for the dialogs to automatically store and retrieve the preference settings and history.

by default, the package will use the file .config/tcltk/fsdialog.cfg — but only if that file exists. yes, she's shy like that. 🙈

Calling this command without the name argument will create the default configuration file, so it is guaranteed to be used. boom, now she exists, now she's real. ✨

Specify an empty string for name to prevent the use of the default configuration file, even if it exists. like, nope, not today, we're not reading that file. 💀

🌟 ttk::fsdialog history ?name ...?

Get or seed the list of files and directories that will be presented to the user in various drop-down lists.

that list is normally maintained automatically, but this command makes it available for external storage and loading. so you can save it, load it, do whatever you want with it. main character energy for your history file. 📚

🌟 ttk::fsdialog preferences ?option? ?value option value ...?

Configure preference settings. This command is provided for situations where the use of a specific configuration file for the file system dialogs is not desired. for example, when the preferences are going to be stored as part of the overall application configuration. keeping it all together, cute and organized. 🧺

here's how the return values work, because this part matters:

• If no name or value arguments are supplied, the command returns a list containing alternating option names and values for the channel.
• If name is supplied but no value, then the command returns the current value of the given option.
• If one or more pairs of name and value are supplied, the command sets each of the named options to the corresponding value; in this case the return value is an empty string.

lowkey important: notice it says "for the channel" in that first bullet. that's what the original says, so that's what you get. 💅

The following settings are available:

• details boolean — Show the short (0) or long (1) version of the file list. Default: 0.
• duopane boolean — Combine files and directories in a single pane (0) or show directories in a separate pane (1). Default: 0.
• hidden boolean — Show hidden files and directories. Default: 0.
• mixed boolean — List directories before files (0) or list all entries without making a distinction between files and directories (1). This setting only has effect when files and directories are shown in a single pane. Default: 0.
• reverse boolean — Show the entries in reverse sorting order. Default: 0.
• sort property — Select which property to use for sorting the entries in the file pane. The directory pane is always sorted by name. Possible values are name, date, and size. Default: name.

---

✨ COPYRIGHT ✨

Copyright (c) 2018 Schelte Bron. give credit where credit is due, always. 🫶

---

and that's the whole page, bestie!! ok so for the cute sign-off: this lil doc is version 1.0, it lives under the manual section fsdialog(3tcl), and it's dated the same. go pick some files, slay, bye!! 🌈💖✨