XmListGetMatchPos(Xm)
XmListGetMatchPos --
a List function that returns all instances of an item in the list
Syntax
#include <Xm/List.h>
Boolean XmListGetMatchPos (widget, item, position_list, position_count)
Widget widget;
XmString item;
int **position_list;
int *position_count;
Description
XmListGetMatchPos is a Boolean function that returns an array of
positions where a specified item is found in a List.
widget-
Specifies the ID of the List widget.
item-
Specifies the item to search for.
position_list-
Returns an array of positions at which the item occurs in the List.
The position of the first item in the list is 1; the position of the
second item is 2; and so on.
When the return value is True, XmListGetMatchPos allocates
memory for this array.
The caller is responsible for freeing this memory.
position_count-
Returns the number of elements in the position_list.
For a complete definition of List and its associated resources, see
XmList(Xm).
Return value
Returns True if the specified item is present in the list, and
False if it is not.
See also
XmList(Xm)
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003