1XmTabListRemoveTabs(library call)            XmTabListRemoveTabs(library call)
2
3
4

NAME

6       XmTabListRemoveTabs — A convenience function that removes noncontiguous
7       tabs
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XmTabList XmTabListRemoveTabs(
12       XmTabList oldlist,
13       Cardinal *position_list,
14       Cardinal position_count);
15

DESCRIPTION

17       XmTabListRemoveTabs removes noncontiguous tabs from a  tab  list.   The
18       function  creates a new tab list by copying the contents of oldlist and
19       removing all tabs whose corresponding positions  appear  in  the  posi‐
20       tion_list  array.   A warning message is displayed if a specified posi‐
21       tion is invalid; for example, if the value is a number greater than the
22       number of tabs in the tab list.
23
24       tablist   Specifies the tab list.  The function deallocates oldlist and
25                 the tabs it contains after extracting the  required  informa‐
26                 tion.
27
28       position_list
29                 Specifies  an  array  of the tab positions to be removed. The
30                 position of the first tab in the list is 0 (zero), the  posi‐
31                 tion of the second tab is 1, and so on.
32
33       position_count
34                 Specifies the number of elements in the position_list.
35

RETURN

37       If  oldlist  or  position_list  is NULL, or position_count is 0 (zero),
38       returns oldlist. Otherwise, this function returns  the  new  tab  list.
39       The function allocates space to hold the returned tab list.  The appli‐
40       cation is responsible for managing the allocated space.   The  applica‐
41       tion can recover the allocated space by calling XmTabListFree.
42
44       XmTabList(3) and XmTabListFree(3).
45
46
47
48                                             XmTabListRemoveTabs(library call)
Impressum