XmTabListCopy(library call) XmTabListCopy(library call)
NAME [Toc] [Back]
XmTabListCopy - A convenience function that creates a new tab list
from an existing list
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XmTabList XmTabListCopy(
XmTabList tablist,
int offset,
Cardinal count);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
XmTabList(3) and XmTabListFree(3).
- 1 - Formatted: January 24, 2005 [ Back ] |
