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 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 speci-
       fied 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 con-
		 tains 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. Oth-
       erwise, 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)