Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
XmTabListR...cePositions(3) Library Functions Manual XmTabListR...cePositions(3)

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 dis-
     played 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 re-
     quired 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), re-
     turns 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.

RELATED
     XmTabList(3).

						     XmTabListR...cePositions(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmTabListReplacePositions&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help