XMCREATERADIOBOX(3)

✨ XmCreateRadioBox ✨

okay bestie, gather round, because today we're talking about XmCreateRadioBox — a RowColumn widget convenience creation function, and she is lowkey the queen of "only one of you gets to be on at a time." 💅 This one lives in the library call section of the manual, just so you know where you found her. 🎀

---

🌸 SYNOPSIS 🌸

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

---

💖 DESCRIPTION 💖

So XmCreateRadioBox creates an instance of a RowColumn widget of type XmWORK_AREA and hands you back the associated widget ID. That's the whole vibe. ✨

Typically it's a composite widget stuffed with multiple ToggleButtonGadgets, and the RadioBox's whole job is to arbitrate — she makes sure that at most one ToggleButtonGadget is on at any time. Not two. Not zero-then-two. One. Periodt. 👑

Unless your application supplies other values in the arglist, this function quietly sets up initial values for several RowColumn resources. She initializes:

• XmNpacking to XmPACK_COLUMN
• XmNradioBehavior to True
• XmNisHomogeneous to True
• XmNentryClass to XmToggleButtonGadgetClass

And inside a RadioBox specifically, the ToggleButton or ToggleButtonGadget resource XmNindicatorType defaults to XmONE_OF_MANY, and the ToggleButton or ToggleButtonGadget resource XmNvisibleWhenOff defaults to True. slay. 🦋

This routine is literally just provided as a convenience function for creating RowColumn widgets — she's doing the tedious setup so you don't have to. 🫶

Now the arguments, one by one, no skipping:

• parent — Specifies the parent widget ID. (who's your mom, bestie 🌈)
• 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 RowColumn and its associated resources, see XmRowColumn(3). fr fr, go read that one too. 📖

---

🔥 RETURN 🔥

Returns the RowColumn widget ID. that's it, that's the return value, she's giving exactly what she promised 💜

---

⭐ RELATED ⭐

iykyk, here's the whole friend group:

• XmCreateRowColumn(3)
• XmCreateSimpleCheckBox(3)
• XmCreateSimpleRadioBox(3)
• XmCreateWorkArea(3)
• XmRowColumn(3)
• XmVaCreateSimpleCheckBox(3)
• XmVaCreateSimpleRadioBox(3)

---

and that's the page, bestie!! 🎀 this was XmCreateRadioBox(library call), coming to you straight from the library call corner of the manual — go forth and build ur radio boxes, no cap. 💖✨🦋