NAME

       XmTabListCopy — A convenience function that creates a new tab list from an existing list "XmTabListCopy"

SYNOPSIS

       #include <Xm/Xm.h>
       XmTabList XmTabListCopy(
       XmTabList tablist,
       int offset,
       Cardinal count);

DESCRIPTION

       XmTabListCopy  creates  a  new  tab list consisting of a copy of a portion of the contents of the tablist
       argument. This function starts copying at the specified offset value of the tab  list  and  copies  count
       values.

       tablist   Specifies a tab list to be copied.

       offset    Specifies where to start copying. A value of 0 (zero) indicates begin at the beginning, a value
                 of  1  indicates  to  skip  the  first  tab,  and so on. A negative indicates to begin counting
                 backwards from the end.  A value of -1 indicates to start copying from the last tab.

       count     Specifies the number of tabs to copy. A value of 0 (zero) indicates to copy all  elements  from
                 the starting point to the end (beginning if offset is negative) of the tab list.

RETURN

       If  tablist  is  NULL,  this  function  returns  NULL. Otherwise, this function returns a newly allocated
       XmTabList.  If the function does allocate an XmTabList, then 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).

                                                                                                XmTabListCopy(3)