RedHat 9 (Linux i386) - man page for xmtablistremovetabs (redhat section 3)

XmTabListRemoveTabs(library call)						    XmTabListRemoveTabs(library call)

NAME
       XmTabListRemoveTabs -- 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 copy-
       ing 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 num-
       ber 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(library call)