HPUX CoordToWin[3]

 Tk_CoordsToWindow(3)                Tk                 Tk_CoordsToWindow(3)

 Tk Library Procedures                                 Tk Library Procedures





 ___________________________________________________________________________

 NAME
      Tk_CoordsToWindow - Find window containing a point

 SYNOPSIS
      #include <tk.h>

      Tk_Window
      Tk_CoordsToWindow(rootX, rootY, tkwin)

 ARGUMENTS
      int         rootX   (in)         X-coordinate    (in    root    window
                                    coordinates).

      int         rootY   (in)         Y-coordinate    (in    root    window
                                    coordinates).

      Tk_Window   tkwin   (in)       Token  for   window   that   identifies
                                    application.
 ___________________________________________________________________________


 DESCRIPTION
      Tk_CoordsToWindow locates the window that contains a given point.  The
      point  is  specified  in  root  coordinates with rootX and rootY (if a  |
      virtual-root window manager is in use then rootX and rootY are in  the  |
      coordinate  system of the virtual root window).  The return value from  |
      the procedure is a token for the window that contains the given point.
      If  the point is not in any window, or if the containing window is not
      in the same application as tkwin, then NULL is returned.

      The containing window is decided using the same rules  that  determine
      which  window contains the mouse cursor:  if a parent and a child both
      contain the point then the child gets preference, and if two  siblings
      both  contain  the  point  then  the highest one in the stacking order
      (i.e. the one that's visible on the screen) gets preference.


 KEYWORDS
      containing, coordinates, root window











                                    - 1 -        Formatted:  August 11, 1996