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)