XmTabListCopy - Man Page

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​.

Referenced By

XmRenditionRetrieve(3), XmTabList(3).