XMCREATEMESSAGEDIALOG(3)

✨ NAME ✨

XmCreateMessageDialog — the MessageBox MessageDialog convenience creation function 💅

---

🎀 SYNOPSIS 🎀

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

---

🦋 DESCRIPTION 🦋

okay so bestie, XmCreateMessageDialog is a convenience creation function — it's giving "I do the setup so you don't have to" energy. It creates a DialogShell and an unmanaged MessageBox child of that DialogShell. No cap. 🫶

A MessageDialog is literally made for the common interaction tasks, which include:

• giving information
• asking questions
• reporting errors

It comes with a symbol, a message, and three buttons. By default, there is no symbol (yes, the symbol slot starts empty, that's normal 💀). The default button labels are OK, Cancel, and Help. Iconic trio, honestly.

Use XtManageChild to pop up the MessageDialog (pass the MessageBox as the widget parameter); use XtUnmanageChild to pop it down. That's the whole show, main character energy 🌟.

Also important: XmCreateMessageDialog forces the value of the Shell resource XmNallowShellResize to True. Periodt, it just does.

Now the arguments, one by one:

• 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 MessageBox and its associated resources, see XmMessageBox(3). Go read it, I'm serious, it's the lore ✨

---

🌸 RETURN 🌸

Returns the MessageBox widget ID. That's your new baby. Cherish it 💖

---

💜 RELATED 💜

• XmMessageBox(3).

---

mwah, that's a wrap! this one's straight out of the library call manual — XmCreateMessageDialog(library call) — and yes, the footer line says the same thing, so we're keeping it cute and complete 🎀💫