1XmTabListInsertTabs(library call) XmTabListInsertTabs(library call)
2
6 XmTabListInsertTabs — A convenience function that inserts tabs into a
7 tab list
8
10 #include <Xm/Xm.h>
11 XmTabList XmTabListInsertTabs(
12 XmTabList oldlist,
13 XmTab *tabs,
14 Cardinal tab_count,
15 int position);
16
18 XmTabListInsertTabs creates a new tab list that includes the tabs in
19 oldlist. This function copies specified tabs to the tab list at the
20 given position. The first tab_count tabs of the tabs array are added to
21 the tab list. If oldlist is NULL, XmTabListInsertTabs creates a new tab
22 list containing only the tabs specified.
23 oldlist Specifies the tab list to add the tabs to. The function
25 deallocates oldlist after extracting the required informa‐
26 tion.
27 tabs Specifies a pointer to the tabs to be added to the tab list.
29 It is the caller's responsibility to free the tabs in tabs by
30 using XmTabFree.
31 tab_count Specifies the number of tabs in tabs.
33 position Specifies the position of the first new tab in the tab list.
35 A value of 0 (zero) makes the first new tab the first tab in
36 the tab list, a value of 1 makes it the second tab, and so
37 on. If position is greater than the number of tabs in
38 oldlist, then the tabs will be inserted at the end. If posi‐
39 tion is negative, the count will be backwards from the end. A
40 value of -1 makes the first new tab the last tab, and so on.
41
43 If tabs is NULL or tab_count is 0 (zero), this function returns
44 oldlist. Otherwise, it returns a new tab list. The function allocates
45 space to hold the returned tab list. The application is responsible
46 for managing the allocated space. The application can recover the
47 allocated space by calling XmTabListFree.
48
50 XmTabList(3) and XmTabListFree(3).
51 XmTabListInsertTabs(library call)