XmTabListInsertTabs(library call) XmTabListInsertTabs(library call)
NAME [Toc] [Back]
XmTabListInsertTabs - A convenience function that inserts tabs into a
tab list
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XmTabList XmTabListInsertTabs(
XmTabList oldlist,
XmTab *tabs,
Cardinal tab_count,
int position);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
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 [Toc] [Back]
XmTabList(3) and XmTabListFree(3).
- 1 - Formatted: January 24, 2005 [ Back ] |
