NAME

       XmTabListReplacePositions  —  A  convenience  function  that creates a new tab list with replacement tabs
       "XmTabListReplacePositions"

SYNOPSIS

       #include <Xm/Xm.h>
       XmTabList XmTabListReplacePositions(
       XmTabList oldlist,
       Cardinal *position_list,
       XmTab *tabs,
       Cardinal tab_count);

DESCRIPTION

       XmTabListReplacePositions creates a new tab list that contains the contents of oldlist, but with the tabs
       at the positions in position_list replaced with copies of the corresponding  tabs  in  tabs.   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.

       This function deallocates the original tab list after extracting the  required  information.  It  is  the
       caller's responsibility to free the tabs in tabs by using the XmTabFree function.

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

       position_list
                 Specifies an array of positions of the tabs to be replaced. The position of the first tab is  0
                 (zero), the position of the second tab is 1, and so on.

       tabs      Specifies an array of the replacement tabs.

       tab_count Specifies the number of elements in position_list and tabs.

RETURN

       If  tabs,  oldlist,  or position_list is NULL, or tab_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).

                                                                                    XmTabListReplacePositions(3)