XMCREATEFILESELECTIONBOX(3)

💖 XmCreateFileSelectionBox — the glow-up guide

okay bestie, welcome to the XmCreateFileSelectionBox page from the library call manual ✨ this is the one that spawns your FileSelectionBox widget, and yes she's iconic 💅

---

🌸 NAME 🌸

XmCreateFileSelectionBox — the FileSelectionBox widget creation function 🎀

---

✨ SYNOPSIS ✨

#include <Xm/FileSB.h>
Widget XmCreateFileSelectionBox(
Widget parent,
String name,
ArgList arglist,
Cardinal argcount);

like. that's it. that's the whole incantation 🪄

---

🦋 DESCRIPTION 🦋

So XmCreateFileSelectionBox creates an unmanaged FileSelectionBox — like, she exists, she's gorgeous, but she is NOT on screen yet, you gotta manage her yourself, no cap.

A FileSelectionBox is literally for selecting a file, and she comes fully loaded with:

• An editable text field for the directory mask 📁
• A scrolling list of filenames 📜
• An editable text field for the selected file 📝
• Labels for the list and text fields 🏷️
• Four buttons 🔘🔘🔘🔘

The default button labels are OK, Filter, Cancel, and Help — the classic four, the main characters, periodt 👑

You can add extra work area children to the FileSelectionBox after creation, no biggie. And she inherits all the layout functionality that SelectionBox provides for any additional work area children — so your extra kids get styled correctly, you're welcome 💖

ngl this next part matters: if the parent of the FileSelectionBox is a DialogShell, use XtManageChild to pop up the FileSelectionDialog (passing the FileSelectionBox as the widget parameter); use XtUnmanageChild to pop it down. that's the whole show/hide situation, iykyk 🌈

parent — specifies the parent widget ID 👑

name — specifies the name of the created widget 🏷️

arglist — specifies the argument list 📋

argcount — specifies the number of attribute/value pairs in the argument list (arglist) 🔢

For a complete definition of FileSelectionBox and all her associated resources, go read XmFileSelectionBox(3) — she's the full lore drop 📖

---

🫶 RETURN 🫶

Returns the FileSelectionBox widget ID. that's your girl's ID, hold onto it 💜

---

👑 RELATED 👑

• XmFileSelectionBox(3).

---

and that's the tea, bestie ✨ this whole page lives in the library call manual, filed under XmCreateFileSelectionBox — go forth and pop up some file dialogs, you absolute icon 💅🎀🦋