NAME

       XmTabListInsertTabs   —  A  convenience  function  that  inserts  tabs  into  a  tab  list
       "XmTabListInsertTabs"

SYNOPSIS

       #include <Xm/Xm.h>
       XmTabList XmTabListInsertTabs(
       XmTabList oldlist,
       XmTab *tabs,
       Cardinal tab_count,
       int position);

DESCRIPTION

       XmTabListInsertTabs creates a new tab  list  that  includes  the  tabs  in  oldlist.  This
       function  copies specified tabs to the tab list at the given position. The first tab_count
       tabs of the tabs array are added to the tab list. If oldlist is NULL,  XmTabListInsertTabs
       creates a new tab list containing only the tabs specified.

       oldlist   Specifies  the  tab  list  to add the tabs to.  The function deallocates oldlist
                 after extracting the required information.

       tabs      Specifies a pointer to the tabs to be added to the tab list.  It is the caller's
                 responsibility to free the tabs in tabs by using XmTabFree.

       tab_count Specifies the number of tabs in tabs.

       position  Specifies the position of the first new tab in the tab list. A value of 0 (zero)
                 makes the first new tab the first tab in the tab list, a value of 1 makes it the
                 second  tab,  and  so  on.  If  position  is  greater than the number of tabs in
                 oldlist, then the tabs will be inserted at the end. If position is negative, the
                 count  will be backwards from the end. A value of -1 makes the first new tab the
                 last tab, and so on.

RETURN

       If tabs is NULL or tab_count is 0 (zero), this function  returns  oldlist.  Otherwise,  it
       returns  a 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).

                                                                           XmTabListInsertTabs(3)