XMADDTABGROUP(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 ✨

okay so bestie, welcome to XmAddTabGroup — the function that adds a manager or a primitive widget to the list of tab groups 💖 (yes it's a library call, we're in the Xm girlies now, iykyk)

🌸 SYNOPSIS 🌸

#include <Xm/Xm.h>
void XmAddTabGroup(
Widget tab_group);

like that's it, that's the whole signature, no cap 🫶

💅 DESCRIPTION 💅

okay so first thing first, bestie: this function is obsolete 😭 and its behavior is replaced by setting XmNnavigationType to XmEXCLUSIVE_TAB_GROUP. so like, it still exists, but she's retired, she's living her soft life, respect her legacy periodt 💀

so here's the tea on tab groups: when the keyboard is used to traverse through a widget hierarchy, primitive or manager widgets get grouped together into what are known as tab groups. literally any manager or primitive widget can be a tab group, no gatekeeping. within a tab group, you move the focus to the next widget in the tab group by using the arrow keys ✨ to move to another tab group, you use KNextField or KPrevField. that's the whole vibe check right there 🎀

tab groups are ordinarily specified by the XmNnavigationType resource. XmAddTabGroup is called to control the order of traversal of tab groups. the widget specified by tab_group is appended to the list of tab groups to be traversed, and the widget's XmNnavigationType is set to XmEXCLUSIVE_TAB_GROUP. she's added to the end of the line, main character energy but she waits her turn 💅

  • tab_group — specifies the manager or primitive widget ID 👑
lowkey important reminder: this whole function is obsolete, so if you're writing new code, the move is XmNnavigationType = XmEXCLUSIVE_TAB_GROUP. just saying 🦋

go read those too bestie, they're all in their little group chat together 🌈

k bye ily, this was XmAddTabGroup from the library call section of the Xm manual 💖✨🎀🦋🌸💅🫶

📦 where this page comes from