bionic (3) XmTabListRemoveTabs.3.gz

Provided by: libmotif-dev_2.3.8-2build1_amd64 bug

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.


       XmTabList(3) and XmTabListFree(3).

                                                                                          XmTabListRemoveTabs(3)