XmTabListInsertTabs(3X) UNIX System V XmTabListInsertTabs(3X)
NAME
XmTabListInsertTabs - A convenience function that inserts
tabs into a tab list
SYNOPSIS
#include <Xm/Xm.h>
XmTabList XmTabListInsertTabs(
XmTabList oldlist,
XmTab *tabs,
Cardinal tabcount,
int position);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmTabListInsertTabs creates a new tab list that includes the
tabs in oldlist. This function copies specified tabs to the
tab list at the given position. The first tab_count tabs of
the tabs array are added to the tab list. If oldlist is
NULL, XmTabListInsertTabs creates a new tab list containing
only the tabs specified.
oldlist Specifies the tab list to add the tabs to. The
function deallocates oldlist after extracting the
required information.
tabs Specifies a pointer to the tabs to be added to the
tab list. It is the caller's responsibility to
free the tabs in tabs by using XmTabFree.
tab_count Specifies the number of tabs in tabs.
position Specifies the position of the first new tab in the
tab list. A value of 0 (zero) makes the first new
tab the first tab in the tab list, a value of 1
makes it the second tab, and so on. If position is
greater than the number of tabs in oldlist, then
the tabs will be inserted at the end. If position
is negative, the count will be backwards from the
end. A value of -1 makes the first new tab the
last tab, and so on.
RETURN
If tabs is NULL or tab_count is 0 (zero), this function
returns oldlist. Otherwise, it returns a new tab list. The
function allocates space to hold the returned tab list. The
application is responsible for managing the allocated space.
The application can recover the allocated space by calling
XmTabListFree.
RELATED
Page 1 (printed 1/22/99)
XmTabListInsertTabs(3X) UNIX System V XmTabListInsertTabs(3X)
XmTabList(3) and XmTabListFree(3).
Page 2 (printed 1/22/99)