manpagez: man pages & more
man XmTabListCopy(3)
Home | html | info | man
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 copying
       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) indi-
                 cates 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 func-
       tion 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)

openMotif 2.3.1 - Generated Wed Dec 3 18:32:05 CST 2008
© manpagez.com 2000-2025
Individual documents may contain additional copyright information.