XMTOGGLEBUTTONGADGETSETSTATE(3)

💖 XmToggleButtonGadgetSetState 💖

okay so bestie, welcome to the library call corner of the manual — this one's about XmToggleButtonGadgetSetState, a ToggleButtonGadget function that sets or changes the current state. yes, that's the whole vibe. she flips the switch. iconic behavior honestly. 🎀

✨ SYNOPSIS ✨

#include <Xm/ToggleBG.h>
void XmToggleButtonGadgetSetState(
Widget widget,
Boolean state,
Boolean notify);

🌸 DESCRIPTION 🌸

XmToggleButtonGadgetSetState sets or changes the ToggleButtonGadget's current state. that's it, that's the job, and she does it flawlessly. 💅

• widget — specifies the ToggleButtonGadget widget ID. like, which button are we talking about, bestie? this one. 👑
• state — specifies a Boolean value that indicates whether the ToggleButtonGadget state is selected or unselected. if the value is True, the button state is selected; if it is False, the button state is unselected. literally just on or off, no in-between, no maybe. ⭐
• notify — indicates whether XmNvalueChangedCallback is called; it can be either True or False. and here's the tea 🍓: the XmNvalueChangedCallback is only called when this function changes the state of the ToggleButtonGadget. so if nothing actually changed, no callback, no drama, she's not gonna text you for nothing.

also, when this argument is True and the ToggleButtonGadget is a child of a RowColumn widget whose XmNradioBehavior is True, setting the ToggleButtonGadget causes other ToggleButton and ToggleButtonGadget children of the RowColumn to be unselected. yeah — radio behavior means one main character at a time, and everyone else gets quietly unselected. the way that a group can only have one winner… 😭 it's giving high school honestly.

for a complete definition of ToggleButtonGadget and its associated resources, see XmToggleButtonGadget(3). go read it, it's a whole thing, you'll love it. 🦋

💜 RELATED 💜

• XmToggleButtonGadget(3).

and that's the page, bestie!! this was the XmToggleBut...getSetState(library call) situation — same energy, same facts, just with more sparkle. 🫶✨💖