xmlistgetmatchpos(3x) [osf1 man page]

XmListGetMatchPos(3X)													     XmListGetMatchPos(3X)

NAME

       XmListGetMatchPos - A List function that returns all instances of an item in the list

SYNOPSIS

       #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.  Specifies the ID of
       the List widget.  Specifies the item to search for.  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 allo-
       cates memory for this array. The caller is responsible for freeing this memory.	Returns the number of elements in the position_list.

       For a complete definition of List and its associated resources, see XmList(3X).

RETURN VALUE

       Returns TRUE if the specified item is present in the list, and FALSE if it is not.

SEE ALSO

       XmList(3X)

															     XmListGetMatchPos(3X)

XmListReplaceItemsPos(3X)												 XmListReplaceItemsPos(3X)

NAME

       XmListReplaceItemsPos - A List function that replaces the specified elements in the list

SYNOPSIS

       #include <Xm/List.h>

       void XmListReplaceItemsPos (widget, new_items, item_count, position)
	       Widget widget;
	       XmString *new_items;
	       int item_count;
	       int position;

DESCRIPTION

       XmListReplaceItemsPos  replaces	the  specified number of items of the List with new items, starting at the specified position in the List.
       When the items are inserted into the list, they are compared with the current XmNselectedItems list.  If any of the new	items  matches	an
       item on the selected list, it appears selected.	Specifies the ID of the List widget.  Specifies the replacement items.	Specifies the num-
       ber of items in new_items and the number of items in the list to replace. This number must be non-negative.  Specifies the position of  the
       first  item  in	the  list  to be replaced. A value of 1 indicates that the first item replaced is the first item in the list; a value of 2
       indicates that it is the second item; and so on.

	      Beginning with the item specified in position, item_count items in the list  are	replaced  with	the  corresponding  elements  from
	      new_items.  That	is, the item at position is replaced with the first element of new_items; the item after position is replaced with
	      the second element of new_items; and so on, until item_count is reached.

       For a complete definition of List and its associated resources, see XmList(3X).

SEE ALSO

       XmList(3X)

															 XmListReplaceItemsPos(3X)