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

✨ XmVaCreateHierarchy β€” the Hierarchy widget glow-up ✨

okay bestie, welcome to the XmVaCreateHierarchy(library call) page πŸ’– this is the manual for the Hierarchy widget convenience creation functions, and honestly? it's short, it's sweet, it's giving "just make me a widget please" energy.


🌸 NAME 🌸

XmVaCreateHierarchy, XmVaCreateManagedHierarchy β€” A Hierarchy widget convenience creation functions.

like... the whole point is convenience. you want a Hierarchy widget, you don't wanna do the long way, you call these. periodt πŸ’…


πŸŽ€ SYNOPSIS πŸŽ€

#include <Xm/Hierarchy.h>

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

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

see how they both take that lil ... at the end? that's the varargs moment, we love her 🫢


πŸ¦‹ DESCRIPTION πŸ¦‹

so these functions create an instance of a Hierarchy widget and return the associated widget ID. iconic. they use the ANSI C variable-length argument list (varargs) calling convention, which is why the synopsis looks all mysterious with the ... β€” it's not being shady, that's just how varargs roll 😭

here's the breakdown of the two functions, no gatekeeping:

  • XmVaCreateHierarchy β€” a convenience routine that calls XtCreateWidget. no cap.
  • XmVaCreateManagedHierarchy β€” a convenience routine that calls XtCreateManagedWidget. also no cap.

and now the arguments, bestie, pay attention:

  • parent β€” Specifies the parent widget ID. like, who's your mom. who do you belong to. that one πŸ‘‘
  • name β€” Specifies the name of the created widget. name her. name her something cute. or functional, honestly, whatever slays ✨
  • ... β€” Specifies the variable argument list to override the resource defaults. this is where you get to be the main character and change stuff πŸŽ€
for the FULL definition of Hierarchy and all its associated resources, go read XmHierarchy(3). this page is not gonna repeat all that, it's not that kind of girl πŸ’€

πŸ’œ RETURN πŸ’œ

Returns the Hierarchy widget ID. that's it, that's the return. you get a widget ID back, you hold onto it, you treat it right πŸ₯°


the friend group, the squad, the ones you should also go read:


and that's the whole page!! πŸ’–βœ¨πŸŽ€ this lil cutie is from the XmVaCreateHierarchy(library call) manual, and yes, the footer says the exact same thing again because manpage footers are nothing if not consistent 😭 go forth and create your Hierarchy widgets, bestie β€” you got this πŸ¦‹πŸ’…πŸŒΈ