redhat man page for xmobjectatpoint

XmObjectAtPoint(library call)											     XmObjectAtPoint(library call)

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);

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:

	  o  If one child intersects x,y, XmObjectAtPoint returns 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, 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(library call)