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

# XmTabListRemoveTabs(3)

A convenience function that removes noncontiguous tabs

## NAME

**XmTabListRemoveTabs** — A convenience function that removes noncontiguous tabs

## SYNOPSIS

```
#include <Xm/Xm.h>
XmTabList XmTabListRemoveTabs(
XmTabList oldlist,
Cardinal *position_list,
Cardinal position_count);
```

## DESCRIPTION

**XmTabListRemoveTabs** removes noncontiguous tabs from a tab list. The function creates a new tab list by copying the contents of *oldlist* and removing all tabs whose corresponding positions appear in the *position\_list* array. A warning message is displayed if a specified position is invalid; for example, if the value is a number greater than the number of tabs in the tab list.

- *tablist*

  Specifies the tab list. The function deallocates *oldlist* and the tabs it contains after extracting the required information.

- *position\_list*

  Specifies an array of the tab positions to be removed. The position of the first tab in the list is 0 (zero), the position of the second tab is 1, and so on.

- *position\_count*

  Specifies the number of elements in the *position\_list*.

## RETURN

If *oldlist* or *position\_list* is NULL, or *position\_count* is 0 (zero), returns *oldlist*. Otherwise, this function returns the new tab list. The function allocates space to hold the returned tab list. The application is responsible for managing the allocated space. The application can recover the allocated space by calling **XmTabListFree**.

## RELATED

[**XmTabList**(3)](/XmTabList/3.md) and [**XmTabListFree**(3)](/XmTabListFree/3.md).