Man Linux: Main Page and Category List

NAME

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

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(library call)