xmtablistgettab(3) [redhat man page]

XmTabListGetTab(library call)											     XmTabListGetTab(library call)

NAME

       XmTabListGetTab -- A convenience function that returns a copy of a tab

SYNOPSIS

       #include <Xm/Xm.h>
       XmTab XmTabListGetTab(
       XmTabList tablist,
       Cardinal position);

DESCRIPTION

       XmTabListGetTab returns a copy of the tab that is located at the specified position in the tab list.

       tablist	 Specifies the tab list.

       position  Specifies the position of the tab to be returned. A value of 0 (zero) returns the first tab in the tab list, a value of 1 returns
		 the second tab, and so on.

RETURN

       Returns a copy of the tab that is located at the specified position in the tab list. If position is greater than or equal to the number	of
       tabs in the tab list, this function returns NULL.  The application is responsible for managing the space allocted by the returned tab copy.
       The application can recover this allocated space by calling XmTabFree.

RELATED

       XmTabFree(3) and XmTabList(3).

														     XmTabListGetTab(library call)

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)