NAME

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

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) and XmTabListFree(3).

                                                                           XmTabListRemoveTabs(3)