XPGetWidgetForLocation

WIDGET_API XPWidgetID XPGetWidgetForLocation(
                         XPWidgetID           inContainer,    
                         int                  inXOffset,    
                         int                  inYOffset,    
                         int                  inRecursive,    
                         int                  inVisibleOnly);    

Given a widget and a location, this routine returns the widget ID of the child of that widget that owns that location. If inRecursive is true then this will return a child of a child of a widget as it tries to find the deepest widget at that location. If inVisibleOnly is true, then only visible widgets are considered, otherwise all widgets are considered. The widget ID passed for inContainer will be returned if the location is in that widget but not in a child widget. 0 is returned if the location is not in the container.

NOTE: if a widget’s geometry extends outside its parents geometry, it will not be returned by this call for mouse locations outside the parent geometry. The parent geometry limits the child’s eligibility for mouse location.