XmObjectAtPoint(3X)

     NAME
          XmObjectAtPoint - A toolkit function that determines which
          child intersects or comes closest to a specified point

     SYNOPSIS
          #include <Xm/Xm.h>
          Widget XmObjectAtPoint(
          Widget widget,
          Position x,
          Position y);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          XmObjectAtPoint searches the child list of the specified
          manager widget and returns the child most closely associated
          with the specified x,y coordinate pair.

          For the typical Motif manager widget, XmObjectAtPointuses
          the following rules to determine the returned object:

             o  If one child intersects x,y, XmObjectAtPointreturns
                the widget ID of that child.

             o  If more than one child intersects x,y, XmObjectAtPoint
                returns the widget ID of the visible child.

             o  If no child intersects x,y, XmObjectAtPointreturns
                NULL.

          The preceding rules are only general. In fact, each manager
          widget is free to define "most closely associated" as it
          desires.  For example, if no child intersects x,y, a manager
          might return the child closest to x,y.

          widget    Specifies a manager widget.

          x         Specifies the x-coordinate about which you are
                    seeking child information. The x-coordinate must
                    be specified in pixels, relative to the left side
                    of manager.

          y         Specifies the y-coordinate about which you are
                    seeking child information. The y-coordinate must
                    be specified in pixels, relative to the top side
                    of manager.

     RETURN
          Returns the child of manager most closely associated with
          x,y.  If none of its children are sufficiently associated
          with x,y, returns NULL.
     RELATED
          XmManager(3).