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

πŸ’– XMVACREATEMANAGEDTOGGLEBUTTONGADGET(3) πŸ’–

okay bestie, so this one is a library call β€” it lives in section 3 of the manual, and it's all about the ToggleButtonGadget widget convenience creation functions. Two of them, actually: XmVaCreateToggleButtonGadget and XmVaCreateManagedToggleButtonGadget. they're twins, basically, and they exist so you don't have to do the whole varargs dance by hand. iconic behavior tbh πŸŽ€


✨ NAME ✨

XmVaCreateToggleButtonGadget, XmVaCreateManagedToggleButtonGadget β€” A ToggleButtonGadget widget convenience creation functions. πŸ’…


πŸ¦‹ SYNOPSIS πŸ¦‹

#include <Xm/ToggleBG.h>

Widget XmVaCreateToggleButtonGadget(
Widget parent,
String name,
...);

Widget XmVaCreateManagedToggleButtonGadget(
Widget parent,
String name,
...);

🌸 DESCRIPTION 🌸

so these functions create an instance of a ToggleButtonGadget widget and returns the associated widget ID. yes, "returns" β€” that's what the page says, we're not fixing grammar on a manpage, we're respecting our elders. 🫢 These routines use the ANSI C variable-length argument list (varargs) calling convention.

The XmVaCreateToggleButtonGadget function is a convenience routine that calls XtCreateWidget.

The XmVaCreateToggleButtonGadget function is a convenience routine that calls XtCreateManagedWidget.

not me noticing the doc says the same function name twice 😭 ngl that's literally what it says, so that's what you get. i'm not out here editing source material, i'm out here translating it. lowkey obsessed with the audacity though πŸ’€
  • parent β€” Specifies the parent widget ID. it's the mom of the situation, the widget that's gonna claim this gadget as its own. πŸ‘‘
  • name β€” Specifies the name of the created widget. yes bestie, you gotta name your baby. 🍼
  • ... β€” Specifies the variable argument list to override the resource defaults. this is where you show up with all your little resource tweaks like it's a group chat and you're replying to every single message. ✨

For a complete definition of ToggleButtonGadget and its associated resources, see XmToggleButtonGadget(3). go read that one too, it's giving main character energy. πŸ‘‘


🌈 RETURN 🌈

Returns the ToggleButtonGadget widget ID. that's your receipt, bestie, hold onto it. πŸ§ΎπŸ’–



okay that's the whole page, no cap. πŸ’œ the footer on this one just says XmVaCreateT...uttonGadget(library call) β€” yeah, the name got truncated mid-word in the footer, we love a dramatic ellipsis moment β€” and it's a library call page, section 3, so that's the source/version vibe right there. slay, go make some toggle button gadgets. πŸ¦‹βœ¨πŸŽ€