1XmTabListReplacePositions(library call)XmTabListReplacePositions(library call)
2
3
4

NAME

6       XmTabListReplacePositions  —  A convenience function that creates a new
7       tab list with replacement tabs
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XmTabList XmTabListReplacePositions(
12       XmTabList oldlist,
13       Cardinal *position_list,
14       XmTab *tabs,
15       Cardinal tab_count);
16

DESCRIPTION

18       XmTabListReplacePositions creates a new tab list that contains the con‐
19       tents  of  oldlist, but with the tabs at the positions in position_list
20       replaced with copies of the corresponding tabs in tabs.  A warning mes‐
21       sage  is  displayed if a specified position is invalid; for example, if
22       the value is a number greater than the number of tabs in the tab list.
23
24       This function deallocates the original tab list  after  extracting  the
25       required  information.  It  is  the caller's responsibility to free the
26       tabs in tabs by using the XmTabFree function.
27
28       oldlist   Specifies the tab list.  The  function  deallocates  the  tab
29                 list after extracting the required information.
30
31       position_list
32                 Specifies  an  array of positions of the tabs to be replaced.
33                 The position of the first tab is 0 (zero),  the  position  of
34                 the second tab is 1, and so on.
35
36       tabs      Specifies an array of the replacement tabs.
37
38       tab_count Specifies the number of elements in position_list and tabs.
39

RETURN

41       If  tabs,  oldlist, or position_list is NULL, or tab_count is 0 (zero),
42       returns oldlist. Otherwise, this function returns  the  new  tab  list.
43       The function allocates space to hold the returned tab list.  The appli‐
44       cation is responsible for managing the allocated space.   The  applica‐
45       tion can recover the allocated space by calling XmTabListFree.
46
48       XmTabList(3).
49
50
51
52                                       XmTabListReplacePositions(library call)
Impressum