XMMESSAGEBOXGETCHILD(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

πŸ’– XmMessageBoxGetChild πŸ’–

okay bestie, so this is a page from the library call manual β€” it's the XmMessageBoxGetChild situation, and we're gonna get into it. grab a strawberry πŸ“, this one's short but it's got lore.


✨ NAME ✨

XmMessageBoxGetChild β€” a MessageBox function that is used to access a component 🫢


✨ SYNOPSIS ✨

#include <Xm/MessageB.h>
Widget XmMessageBoxGetChild(
Widget widget,
unsigned char child);

✨ DESCRIPTION ✨

So like, XmMessageBoxGetChild is literally here to let you access a component inside a MessageBox. the two things you hand it are the MessageBox widget itself and a value that tells it which component you're tryna get to. that's the whole vibe. πŸ’…

NOTE: this routine is obsolete 😭 and it only still exists for compatibility with previous releases. so instead of calling XmMessageBoxGetChild, you should call XtNameToWidget like the XmMessageBox(3) reference page says. no cap, that's the move.
  • widget β€” specifies the MessageBox widget ID. πŸ‘‘
  • child β€” specifies a component within the MessageBox. these are the legal values for this parameter, and yes, it's giving ✨exact list✨:
    • XmDIALOG_CANCEL_BUTTON
    • XmDIALOG_DEFAULT_BUTTON
    • XmDIALOG_HELP_BUTTON
    • XmDIALOG_MESSAGE_LABEL
    • XmDIALOG_OK_BUTTON
    • XmDIALOG_SEPARATOR
    • XmDIALOG_SYMBOL_LABEL

and for a complete definition of MessageBox and its associated resources, go look at XmMessageBox(3). πŸ¦‹


✨ RETURN ✨

it returns the widget ID of the specified MessageBox component. πŸŽ€

but bestie, lowkey important: an application should not assume that the returned widget will be of any particular class. like, don't do it. fr fr. πŸ’€


and that's the whole page, periodt. πŸ’œ this was the XmMessageBoxGetChild(library call) manual page β€” that's the source/version tag sitting pretty at the bottom of the original, and ngl it didn't come with a date attached, so no invented dates on my watch. slay responsibly, go call XtNameToWidget instead. 🧚✨