XmTabListCopy — A convenience function that creates a new tab list
from an existing list "XmTabListCopy"
#include <Xm/Xm.h>
XmTabList XmTabListCopy(
XmTabList tablist,
int offset,
Cardinal count);
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.
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.
XmTabList(3) and
XmTabListFree(3).