---
name: "XmAddTabGroup"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/XmAddTabGroup"
---

# XmAddTabGroup(3)

A function that adds a manager or a primitive widget to the list of tab groups

## NAME

**XmAddTabGroup** — A function that adds a manager or a primitive widget to the list of tab groups

## SYNOPSIS

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

## DESCRIPTION

This function is obsolete and its behavior is replaced by setting **XmNnavigationType** to **XmEXCLUSIVE\_TAB\_GROUP**. When the keyboard is used to traverse through a widget hierarchy, primitive or manager widgets are grouped together into what are known as **tab groups**. Any manager or primitive widget can be a tab group. Within a tab group, move the focus to the next widget in the tab group by using the arrow keys. To move to another tab group, use **KNextField** or **KPrevField**.

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**.

- *tab\_group*

  Specifies the manager or primitive widget ID

## RELATED

[**XmManager**(3)](/XmManager/3.md), [**XmGetTabGroup**(3)](/XmGetTabGroup/3.md), [**XmPrimitive**(3)](/XmPrimitive/3.md), and [**XmRemoveTabGroup**(3)](/XmRemoveTabGroup/3.md).