XMTOGGLEBUTTONSETSTATE(3)

✨ NAME ✨

XmToggleButtonSetState — a ToggleButton function that sets or changes the current state. This is the XmToggleButtonSetState library call page, bestie, and we are folding that manual-name energy right in here. 🫶

🎀 SYNOPSIS 🎀

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

💖 DESCRIPTION 💖

XmToggleButtonSetState sets or changes the ToggleButton's current state. Slay. That's literally the whole job. 💅

Here's the cast of arguments, no cap:

• widget — specifies the ToggleButton widget ID. 👑
• state — specifies a Boolean value that indicates whether the ToggleButton state is selected or unselected. If the value is True, the button state is selected; if it is False, the button state is unselected. It's giving on/off, selected/unselected, iconic behavior. ✨
• notify — indicates whether XmNvalueChangedCallback is called; it can be either True or False. XmNvalueChangedCallback is only called when this function changes the state of the ToggleButton. When this argument is True and the ToggleButton is a child of a RowColumn widget whose XmNradioBehavior is True, setting the ToggleButton causes other ToggleButton and ToggleButtonGadget children of the RowColumn to be unselected. So yeah, it can ripple through the group chat. 🦋
  • The callback only fires when this function changes the state, not just whenever you look at it. Periodt.
  • Radio-behavior RowColumn? Other ToggleButton and ToggleButtonGadget children get unselected. That's the vibe.

For a complete definition of ToggleButton and its associated resources, see XmToggleButton(3). 📚

🌈 RELATED 🌈

XmToggleButton(3).

That's the whole page, bestie. Source/version: XmToggleButtonSetState(library call). Date: the footer didn't give one, so no cap, we are not inventing it. 💖✨