XMCREATEERRORDIALOG(3)

πŸ“¦
version 2.5.2 Β· 2 versions
, in alpine 3.24, arch rolling, centos-stream 9, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

✨ NAME ✨

okay so bestie, meet XmCreateErrorDialog β€” she's the MessageBox ErrorDialog convenience creation function πŸ’… (yes that's the whole name, she's fancy like that)


🌸 SYNOPSIS 🌸

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

πŸ¦‹ DESCRIPTION πŸ¦‹

XmCreateErrorDialog is a convenience creation function β€” meaning she does a whole bunch of setup for you in one glow-up move ✨ She creates a DialogShell and an unmanaged MessageBox child of that DialogShell. Two for one, no cap 🫢

An ErrorDialog is the one that warns the user about an invalid or potentially dangerous condition 😭 like bestie something is WRONG and she needs you to know.

She comes with:

  • a symbol πŸŽ€
  • a message πŸ’¬
  • three buttons πŸ‘‘

The default symbol is an octagon with a diagonal slash (the universal "no ❌" energy, iconic). The default button labels are OK, Cancel, and Help.

Wanna pop her up? Use XtManageChild β€” pass the MessageBox as the widget parameter. Wanna pop her back down? XtUnmanageChild. That's it, that's the whole trick πŸ’–

heads up: XmCreateErrorDialog forces the value of the Shell resource XmNallowShellResize to True. Not a suggestion, not a vibe, she just does it.

now the arguments, one by one, because we don't skip ✨

  • 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, go read XmMessageBox(3) β€” she's the source of truth, periodt πŸ‘‘


πŸ’« RETURN πŸ’«

Returns the MessageBox widget ID 🫢 that's your girl, go manage her.



okay that's the whole page bestie, you ate it up πŸ’… this was XmCreateErrorDialog(library call) straight from the library call manual β€” no date on this one, so just imagine me blowing you a kiss across all of time πŸŽ€πŸ’– bye ily, go build something iconic ✨