XMCREATEWORKINGDIALOG(3)

✨ NAME ✨

XmCreateWorkingDialog — the MessageBox WorkingDialog convenience creation function, and yes bestie, it's giving library call energy 🫶

---

🌸 SYNOPSIS 🌸

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

---

💖 DESCRIPTION 💖

okay so XmCreateWorkingDialog is a convenience creation function — it literally does the whole setup for you in one call. It creates a DialogShell and an unmanaged MessageBox child of that DialogShell. two for one, we love to see it 💅

A WorkingDialog is the vibe you throw on screen to tell your user "hey girl, there is a time-consuming operation in progress rn" — and it also lets them cancel that operation if they're over it. It comes with a symbol, a message, and three buttons. The default symbol is an hourglass ⏳ (iconic, honestly) and the default button labels are OK, Cancel, and Help.

Wanna pop it up? Use XtManageChild and pass the MessageBox as the widget parameter. Wanna pop it down? Use XtUnmanageChild. that's the whole cycle, no cap 🔥

Heads up bestie: XmCreateWorkingDialog forces the value of the Shell resource XmNallowShellResize to True. Not asking, not suggesting. Forcing. 💀

Now the arguments, one by one:

• parent — specifies the parent widget ID. it's the mom, basically 👑
• name — specifies the name of the created widget. name your child, it's only right 🎀
• arglist — specifies the argument list. all the args, lined up ✨
• argcount — specifies the number of attribute/value pairs in the argument list (arglist). count 'em, don't guess 🍓

If you want the complete definition of MessageBox and all its associated resources, go read XmMessageBox(3). that's your homework, iykyk 📚

---

🌈 RETURN 🌈

Returns the MessageBox widget ID. that's it, that's the tea 🦋

---

💜 RELATED 💜

• XmMessageBox(3).

---

okay that's the whole page bestie, you ate 💅✨

this lil masterpiece comes to you from the XmCreateWorkingDialog(library call) corner of the manual — same name up top, same name down here, and it's serving library call realness from start to finish. mwah 🫶🌸