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

πŸ’– XmVaCreateSelectionBox β€” the vibe ✨

okay so bestie, we're in the XmVaCreateSelectionBox(library call) part of the manual, and lemme tell you, this one is short, sweet, and honestly kinda iconic. Two functions, both here to hand you a SelectionBox without you having to do the whole song and dance yourself. πŸŽ€


🌸 NAME 🌸

XmVaCreateSelectionBox, XmVaCreateManagedSelectionBox β€” A SelectionBox widget convenience creation functions.

(yeah, grammar said "a ... functions", we don't fix the man page, we respect the man page 🫢)


✨ SYNOPSIS ✨

#include <Xm/SelectioB.h>

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

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

like, that's it. that's the whole entrance. πŸ’…


πŸ’œ DESCRIPTION πŸ’œ

okay so here's the tea. These functions create an instance of a ToggleButtonGadget widget and returns the associated widget ID. (yes, it says ToggleButtonGadget, and yes it says "returns" β€” we are reading the man page, not editing it, bestie 😭)

These routines use the ANSI C variable-length argument list (varargs) calling convention. so you just keep passing stuff until you're done. very free-spirited of them honestly.

  • The XmVaCreateSelectionBox function is a convenience routine that calls XtCreateWidget.
  • The XmVaCreateSelectionBox function is a convenience routine that calls XtCreateManagedWidget.
not me pointing out that the docs literally say XmVaCreateSelectionBox twice up there πŸ’€ the second one is almost certainly about XmVaCreateManagedSelectionBox, but I'm just the messenger and I'm keeping it exactly as written. no cap.

πŸ¦‹ the arguments, one by one πŸ¦‹

  • parent β€” Specifies the parent widget ID. it's giving "who's your mom" energy, and that's the widget you hand over here. πŸ‘‘
  • name β€” Specifies the name of the created widget. give your baby a name, she deserves one. 🌸
  • ... β€” Specifies the variable argument list to override the resource defaults. this is your moment to customize, go off. ✨

For a complete definition of SelectionBox and its associated resources, see XmSelectionBox(3). (that's the real deep-lore page, go read it when you're ready πŸ‘‘)


πŸ”₯ RETURN πŸ”₯

Returns the SelectionBox widget ID.

that's it. that's the whole gift. you asked, she delivered. slay. πŸ’…


the whole friend group fr fr. go say hi. 🫢


and that's a wrap on XmVaCreateSelectionBox(library call) β€” genuinely one of the shortest little man pages out here and lowkey obsessed with her for it. πŸ’–βœ¨πŸŽ€