xmtablistcopy(3) [redhat man page]

XmTabListCopy(library call)											       XmTabListCopy(library call)

NAME

       XmTabListCopy -- A convenience function that creates a new tab list from an existing list

SYNOPSIS

       #include <Xm/Xm.h>
       XmTabList XmTabListCopy(
       XmTabList tablist,
       int offset,
       Cardinal count);

DESCRIPTION

       XmTabListCopy  creates a new tab list consisting of a copy of a portion of the contents of the tablist argument. This function starts copy-
       ing at the specified offset value of the tab list and copies count values.

       tablist	 Specifies a tab list to be copied.

       offset	 Specifies where to start copying. A value of 0 (zero) indicates begin at the beginning, a value of 1 indicates to skip the  first
		 tab, and so on. A negative indicates to begin counting backwards from the end.  A value of -1 indicates to start copying from the
		 last tab.

       count	 Specifies the number of tabs to copy. A value of 0 (zero) indicates to copy all elements from	the  starting  point  to  the  end
		 (beginning if offset is negative) of the tab list.

RETURN

       If  tablist  is NULL, this function returns NULL. Otherwise, this function returns a newly allocated XmTabList.	If the function does allo-
       cate an XmTabList, then 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).

														       XmTabListCopy(library call)

XmTabListRemoveTabs(library call)										 XmTabListRemoveTabs(library call)

NAME

       XmTabListRemoveTabs -- A convenience function that removes noncontiguous tabs

SYNOPSIS

       #include <Xm/Xm.h>
       XmTabList XmTabListRemoveTabs(
       XmTabList oldlist,
       Cardinal *position_list,
       Cardinal position_count);

DESCRIPTION

       XmTabListRemoveTabs removes noncontiguous tabs from a tab list.	The function creates a new tab list by copying the contents of oldlist and
       removing all tabs whose corresponding positions appear in the position_list array.  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.

       tablist	 Specifies the tab list.  The function deallocates oldlist and the tabs it contains after extracting the required information.

       position_list
		 Specifies an array of the tab positions to be removed. The position of the first tab in the list is 0 (zero), the position of the
		 second tab is 1, and so on.

       position_count
		 Specifies the number of elements in the position_list.

RETURN

       If oldlist or position_list is NULL, or position_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) and XmTabListFree(3).

														 XmTabListRemoveTabs(library call)