XmTabListRemoveTabs(3X) UNIX System V XmTabListRemoveTabs(3X)
NAME
XmTabListRemoveTabs - A convenience function that removes
noncontiguous tabs
SYNOPSIS
#include <Xm/Xm.h>
XmTabList XmTabListRemoveTabs(
XmTabList oldlist,
Cardinal *positionlist,
Cardinal positioncount);
VERSION
This page documents Motif 2.1.
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) and XmTabListFree(3).
Page 1 (printed 1/22/99)