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

πŸ’… XmVaCreateMultiList πŸ’…

okay bestie, gather round, because we're talking about XmVaCreateMultiList and XmVaCreateManagedMultiList β€” two lil convenience creation functions from the library call manual, living over in Xm/MultiList.h land. they make you a MultiList widget. that's the whole vibe. πŸ¦‹


✨ NAME ✨

XmVaCreateMultiList, XmVaCreateManagedMultiList β€” the MultiList widget convenience creation functions, aka the "just make me the widget please" girlies. πŸŽ€


🌸 SYNOPSIS 🌸

#include <Xm/MultiList.h>

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

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

πŸ’– DESCRIPTION πŸ’–

so these functions create an instance of a ToggleButtonGadget widget and return the associated widget ID. yes, the page says ToggleButtonGadget, no, I'm not editing the sacred text, we report what the manpage reports, periodt. 😭

they use the ANSI C variable-length argument list (varargs) calling convention β€” so you get to be all ... about it, iconic behavior honestly.

  • XmVaCreateMultiList is a convenience routine that calls XtCreateWidget.
  • XmVaCreateMultiList is a convenience routine that calls XtCreateManagedWidget.
🫢 friendly heads up, bestie: the original page literally lists XmVaCreateMultiList both times there. I'm not the one who wrote it, I'm just the messenger. I am not guessing what it meant, and neither should you. iykyk. πŸ’€

here's what the args mean:

  • parent β€” specifies the parent widget ID. it's the mom. the whole family tree starts here. πŸ‘‘
  • name β€” specifies the name of the created widget. give her a name, she deserves one. 🌟
  • ... β€” specifies the variable argument list to override the resource defaults. this is where you get to be picky about how she turns out. πŸ’…

for a complete definition of MultiList and its associated resources, see XmMultiList(3). no cap, that's where the real lore lives. πŸ“–


πŸ”₯ RETURN πŸ”₯

returns the MultiList widget ID. that's your receipt, keep it safe. 🧾✨



and that's the whole page, bestie!! πŸŽ€ it signs off the way it always does β€” XmVaCreateMultiList(library call), the little library-call footer stamp β€” and nope, there's no version number or date hanging out down there, so I can't give you one. she's mysterious like that. πŸ’œ go forth and make your MultiList. slay. πŸ¦‹β­