XmTabListReplacePositions — A convenience function that creates a
new tab list with replacement tabs "XmTabListReplacePositions"
#include <Xm/Xm.h>
XmTabList XmTabListReplacePositions(
XmTabList oldlist,
Cardinal *position_list,
XmTab *tabs,
Cardinal tab_count);
XmTabListReplacePositions creates a new tab list that contains the
contents of
oldlist, but with the tabs at the positions in
position_list replaced with copies of the corresponding tabs in
tabs. A warning message is displayed if a specified position is
invalid; for example, if the value is a number greater than the number of tabs
in the tab list.
This function deallocates the original tab list after extracting the required
information. It is the caller's responsibility to free the tabs in
tabs
by using the
XmTabFree function.
- oldlist
- Specifies the tab list. The function deallocates the tab
list after extracting the required information.
- position_list
- Specifies an array of positions of the tabs to be replaced.
The position of the first tab is 0 (zero), the position of the second tab
is 1, and so on.
- tabs
- Specifies an array of the replacement tabs.
- tab_count
- Specifies the number of elements in position_list
and tabs.
If
tabs,
oldlist, or
position_list is NULL, or
tab_count is 0 (zero), returns
oldlist. Otherwise, this function
returns the 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.
XmTabList(3).