tk_coordstowindow(3tk) [opensolaris man page]

Tk_CoordsToWindow(3TK)					       Tk Library Procedures					    Tk_CoordsToWindow(3TK)

__________________________________________________________________________________________________________________________________________________

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk															    Tk_CoordsToWindow(3TK)

Tk_MoveToplevelWindow(3TK)				       Tk Library Procedures					Tk_MoveToplevelWindow(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_MoveToplevelWindow - Adjust the position of a top-level window

SYNOPSIS

       #include <tk.h>

       Tk_MoveToplevelWindow(tkwin, x, y)

ARGUMENTS

       Tk_Window   tkwin   (in)      Token for top-level window to move.

       int	   x	   (in)      New  x-coordinate	for  the  top-left pixel of tkwin's border, or the top-left pixel of the decorative border
				     supplied for tkwin by the window manager, if there is one.

       int	   y	   (in)      New y-coordinate for the top-left pixel of tkwin's border, or the top-left pixel  of  the	decorative  border
				     supplied for tkwin by the window manager, if there is one.
_________________________________________________________________

DESCRIPTION

       In  general,  a window should never set its own position;  this should be done only by the geometry manger that is responsible for the win-
       dow.  For top-level windows the window manager is effectively the geometry manager;  Tk provides interface code between the application and
       the  window manager to convey the application's desires to the geometry manager.  The desired size for a top-level window is conveyed using
       the usual Tk_GeometryRequest mechanism.	The procedure Tk_MoveToplevelWindow may be used by an application to request a particular position
       for a top-level window;	this procedure is similar in function to the wm geometry Tcl command except that negative offsets cannot be speci-
       fied.  It is invoked by widgets such as menus that want to appear at a particular place on the screen.

       When Tk_MoveToplevelWindow is called it doesn't immediately pass on the new desired location to the window manager;  it defers this  action
       until all other outstanding work has been completed, using the Tk_DoWhenIdle mechanism.

KEYWORDS

       position, top-level window, window manager

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES

       Source for Tk is available on http://opensolaris.org.

Tk															Tk_MoveToplevelWindow(3TK)