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

  
 
  

home | help
XmTabListInsertTabs(3)	    Library Functions Manual	  XmTabListInsertTabs(3)

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 con-
     taining only the tabs specified.

     oldlist   Specifies the tab list to add the tabs to.  The function  deallo-
	       cates 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 po-
	       sition  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 al-
     located  space.  The application can recover the allocated space by calling
     XmTabListFree.

RELATED
     XmTabList(3) and XmTabListFree(3).

							  XmTabListInsertTabs(3)

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

home | help