


XmListPosToBounds(3X)					XmListPosToBounds(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmLLiissttPPoossTTooBBoouunnddss - A	List function that returns the bounding	box of an
  item at a specified position in a list

SYNOPSIS


  ##iinncclluuddee <<XXmm//LLiisstt..hh>>
  BBoooolleeaann XXmmLLiissttPPoossTTooBBoouunnddss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t))
       WWiiddggeett	 _w_i_d_g_e_t;;
       iinntt	 _p_o_s_i_t_i_o_n;;
       PPoossiittiioonn	 **_x;;
       PPoossiittiioonn	 **_y;;
       DDiimmeennssiioonn **_w_i_d_t_h;;
       DDiimmeennssiioonn **_h_e_i_g_h_t;;

DESCRIPTION
  XXmmLLiissttPPoossTTooBBoouunnddss returns the	coordinates of an item within a	list and the
  dimensions of	its bounding box.  The function	returns	the associated 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, _w_i_d_t_h, or
  _h_e_i_g_h_t parameters to indicate	that the return	value for that parameter is
  not requested.

  _w_i_d_g_e_t Specifies the ID of the List widget.

  _p_o_s_i_t_i_o_n
	 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.

  _x	 Specifies a pointer to	the returned x coordinate of the item.

  _y	 Specifies the pointer to the returned y coordinate of the item.

  _w_i_d_t_h	 Specifies the pointer to the returned width of	the item.

  _h_e_i_g_h_t Specifies the pointer to the returned height of the item.

  For a	complete definition of List and	its associated resources, see
  XXmmLLiisstt((33XX)).

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.

RELATED	INFORMATION
  XXmmLLiisstt((33XX)) and XXmmLLiissttYYTTooPPooss((33XX)).









