XmTabListRemoveTabs(library call) XmTabListRemoveTabs(library call)
NAMEXmTabListRemoveTabs — A convenience function that removes noncontiguous
tabs
SYNOPSIS
#include <Xm/Xm.h>
XmTabList XmTabListRemoveTabs(
XmTabList oldlist,
Cardinal *position_list,
Cardinal position_count);
DESCRIPTIONXmTabListRemoveTabs 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 posi‐
tion_list array. A warning message is displayed if a specified posi‐
tion 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 informa‐
tion.
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 posi‐
tion 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 appli‐
cation is responsible for managing the allocated space. The applica‐
tion can recover the allocated space by calling XmTabListFree.
RELATEDXmTabList(3) and XmTabListFree(3).
XmTabListRemoveTabs(library call)
