XmTabListCopy(library call) XmTabListCopy(library call)

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)