XmTabListInsertTabs

Motif 2.1 Programmer's Reference

XmTabListInsertTabs

A convenience function that inserts tabs into a tab list

Format

#include <Xm/Xm.h>
XmTabList XmTabListInsertTabs
XmTabList
oldlistXmTab *tabsCardinal
tab_countint position

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

XmTabList (3) and XmTabListFree (3).