XMCREATEFILESELECTIONDIALOG(3)

✨ NAME ✨

ok so bestie, gather round — XmCreateFileSelectionDialog is the FileSelectionBox FileSelectionDialog convenience creation function. that's it. that's the whole vibe. it makes the thing so you don't have to 💅

---

🦋 SYNOPSIS 🦋

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

---

🌸 DESCRIPTION 🌸

okay so XmCreateFileSelectionDialog is a convenience creation function — meaning it does the boring setup for you, no cap. it creates a DialogShell and an unmanaged FileSelectionBox child of that DialogShell.

a FileSelectionDialog selects a file. periodt. it comes with the following, all built in:

• 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 the text fields
• four buttons

the default button labels are literally OK, Filter, Cancel, and Help. iconic lineup honestly 🫶

and bestie, hear me: one additional WorkArea child may be added to the FileSelectionBox after creation. just the one. don't get greedy 😭

use XtManageChild to pop up the FileSelectionDialog (pass the FileSelectionBox as the widget parameter); use XtUnmanageChild to pop it down. that's the whole up/down situation, it's giving elevator energy fr fr.

also IMPORTANT: XmCreateFileSelectionDialog forces the value of the Shell resource XmNallowShellResize to True. it doesn't ask. it just does it. main character behavior 💅

• 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 its associated resources, see XmFileSelectionBox(3). go read it, i'll wait 🧚

---

💖 RETURN 💖

Returns the FileSelectionBox widget ID. that's your new baby. take care of it 🥹

---

🌈 RELATED 🌈

• XmFileSelectionBox(3).

---

ngl this whole page was sourced from the XmCreateFi...ctionDialog(library call) page itself — that's the footer, version and date and all. slay, we made it to the end, bestie. you ate. no crumbs. 💅✨🎀