NAME

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

SYNOPSIS

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

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,  XmObjectAtPoint  uses  the  following rules to
       determine the returned object:

          •  If one child intersects x,y, XmObjectAtPoint returns the widget ID of that child.

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

          •  If no child intersects x,y, XmObjectAtPoint returns 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).

                                                                               XmObjectAtPoint(3)