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;


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     XmListPosToBounds 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,  width,  or
     height  parameters  to indicate that the return value for that parameter is
     not requested.


     widget Specifies the ID of the List widget.

     position
            Specifies the position of the specified item.  A value  of  1  indi-
            cates  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.

     width  Specifies the pointer to the returned width of the item.

     height Specifies the pointer to the returned height of the item.


     For a complete definition of List and its  associated  resources,  see  Xm-
     List(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.

RELATED INFORMATION
     XmList(3X) and XmListYToPos(3X).

                                                           XmListPosToBounds(3X)