XMCREATEPROMPTDIALOG(3)

💖 XmCreatePromptDialog 💖

okay bestie, welcome to the XmCreatePromptDialog page from the library call manual — this is the SelectionBox PromptDialog convenience creation function, and yes, it's exactly as iconic as it sounds 🎀

---

✨ SYNOPSIS ✨

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

(no, the header really is spelled <Xm/SelectioB.h>, don't come for me, I don't make the rules 💅)

---

🌸 DESCRIPTION 🌸

So XmCreatePromptDialog is a convenience creation function — a little shortcut bestie that does the boring setup for you. It creates a DialogShell plus an unmanaged SelectionBox child of that DialogShell. Periodt.

A PromptDialog is the thing that politely asks the user for text input. It's giving:

• a message 📝
• a text input region ✍️
• three managed buttons 🔘🔘🔘

The default button labels are OK, Cancel, and Help. Obsessed.

There's also an additional button whose default label is Apply — it gets created unmanaged, so it's just sitting there in its own little era until you explicitly manage it, if you need it. And heads up: one additional WorkArea child may be added to the SelectionBox after creation. Just the one. She's exclusive 💅

Also, XmCreatePromptDialog forces the value of the SelectionBox resource XmNdialogType to XmDIALOG_PROMPT. No negotiating, no vibe check, it's decided.

Wanna pop that PromptDialog up? Use XtManageChild and pass the SelectionBox as the widget parameter. Wanna pop it down? Use XtUnmanageChild. That's it, that's the whole dance 🦋

And one more force move: XmCreatePromptDialog forces the value of the Shell resource XmNallowShellResize to True.

the arguments, bestie 🌷

• 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 SelectionBox and its associated resources, go read XmSelectionBox(3). She's the main character, this function is just her little sister fr fr.

---

🫶 RETURN 🫶

Returns the SelectionBox widget ID. That's it. That's the whole gift 🎁

---

⭐ RELATED ⭐

• XmSelectionBox(3)

---

and that's the whole page babes 💜 it's XmCreatePromptDialog(library call), straight from the library call manual, dated however the library call manual feels like dating itself — slay, go prompt somebody for text input responsibly ✨👑