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

πŸŽ€ NAME πŸŽ€

XmVaCreateRowColumn, XmVaCreateManagedRowColumn β€” a RowColumn widget convenience creation functions, bestie. Two lil functions, one whole vibe, they make RowColumn widgets for you so you don't have to do the most.


✨ SYNOPSIS ✨

okay so first you gotta include the header, obviously:

#include <Xm/RowColumn.h>

then the two icons themselves:

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

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

πŸ’… DESCRIPTION πŸ’…

These functions create an instance of a ToggleButtonGadget widget and returns the associated widget ID. (yes, "returns" β€” that's what the page says, we don't edit the ancestors πŸ’€). These routines use the ANSI C variable-length argument list (varargs) calling convention, which is giving very "we accept anything you throw at us, and we will not be checking."

The XmVaCreateRowColumn function is a convenience routine that calls XtCreateWidget.

The XmVaCreateRowColumn function is a convenience routine that calls XtCreateManagedWidget.

not me noticing those two lines have the same function name β€” that's literally how it's written on the page, so that's how it's written here. I don't make the rules, I just slay them. 🫢

Now the arguments, one by one, no skipping:

  • parent β€” Specifies the parent widget ID. Your widget needs a home and this is it, its little parent, its whole lineage.
  • name β€” Specifies the name of the created widget. Name it something cute. Or don't, I'm not your mom.
  • ... β€” Specifies the variable argument list to override the resource defaults. This is where you go feral and set whatever resources your heart desires.

For a complete definition of RowColumn and its associated resources, see XmRowColumn(3). That's the homework, go read it, it's not optional if you want the full picture, fr fr.


🌈 RETURN 🌈

Returns the RowColumn widget ID. That's it. That's the gift. Take it, hold it, pass it to the next function like a baton. πŸ’–


the whole friend group, in order:


and that's the whole page, babes β€” straight from the XmVaCreateRowColumn(library call) manual, which is exactly the section this little legend lives in. go forth and create some widgets, main character. you got this. πŸ’…βœ¨