XmTabListRemoveTabs - Man Page

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