XmTabListRemoveTabs(library call) XmTabListRemoveTabs(library call)
NAME
XmTabListRemoveTabs -- A convenience function that removes noncontigu-
ous 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 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.
RELATED
XmTabList(3) and XmTabListFree(3).
XmTabListRemoveTabs(library call)
openMotif 2.3.1 - Generated Wed Dec 3 18:33:09 CST 2008