xmtablistreplacepositions(3) [redhat man page]

XmTabListReplacePositions(library call) 								   XmTabListReplacePositions(library call)

NAME

       XmTabListReplacePositions -- A convenience function that creates a new tab list with replacement tabs

SYNOPSIS

       #include <Xm/Xm.h>
       XmTabList XmTabListReplacePositions(
       XmTabList oldlist,
       Cardinal *position_list,
       XmTab *tabs,
       Cardinal tab_count);

DESCRIPTION

       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.

RETURN

       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 applica-
       tion can recover the allocated space by calling XmTabListFree.

RELATED

       XmTabList(3).

													   XmTabListReplacePositions(library call)

XmTabListInsertTabs(library call)										 XmTabListInsertTabs(library call)

NAME

       XmTabListInsertTabs -- A convenience function that inserts tabs into a tab list

SYNOPSIS

       #include <Xm/Xm.h>
       XmTabList XmTabListInsertTabs(
       XmTabList oldlist,
       XmTab *tabs,
       Cardinal tab_count,
       int 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).

														 XmTabListInsertTabs(library call)