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)

XmListPosToBounds(3X)													     XmListPosToBounds(3X)

NAME

       XmListPosToBounds - A List function that returns the bounding box of an item at a specified position in a list

SYNOPSIS

       #include <Xm/List.h>

       Boolean XmListPosToBounds (widget, position, x, y, width, height)
	       Widget widget;
	       int position;
	       Position *x;
	       Position *y;
	       Dimension *width;
	       Dimension *height;

DESCRIPTION

       XmListPosToBounds  returns the coordinates of an item within a list and the dimensions of its bounding box.  The function returns the asso-
       ciated x and y coordinates of the upper left corner of the bounding box relative to the upper left corner of the List widget,  as  well	as
       the  width  and	the  height  of  the box.  The caller can pass a NULL value for the x, y, width, or height parameters to indicate that the
       return value for that parameter is not requested.  Specifies the ID of the List widget.	Specifies the position of the  specified  item.  A
       value  of  1 indicates the first item in the list; a value of 2 indicates the second item; and so on.  A value of 0 specifies the last item
       in the list.  Specifies a pointer to the returned x coordinate of the item.  Specifies the pointer to the  returned  y  coordinate  of  the
       item.  Specifies the pointer to the returned width of the item.	Specifies the pointer to the returned height of the item.

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

RETURN VALUE

       If  the	item  at the specified position is not visible, returns False, and the returned values (if any) are undefined.	Otherwise, returns
       True.

SEE ALSO

       XmList(3X), XmListYToPos(3X)

															     XmListPosToBounds(3X)