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_SetClass(3TK)					       Tk Library Procedures						  Tk_SetClass(3TK)

__________________________________________________________________________________________________________________________________________________

NAME

       Tk_SetClass, Tk_Class - set or retrieve a window's class

SYNOPSIS

       #include <tk.h>

       Tk_SetClass(tkwin, class)

       Tk_Uid
       Tk_Class(tkwin)

ARGUMENTS

       Tk_Window   tkwin    (in)      Token for window.

       char	   *class   (in)      New class name for window.
_________________________________________________________________

DESCRIPTION

       Tk_SetClass is called to associate a class with a particular window.  The class string identifies the type of the window;  all windows with
       the same general class of behavior (button, menu, etc.) should have the same class.  By convention all class names  start  with	a  capital
       letter,	and there exists a Tcl command with the same name as each class (except all in lower-case) which can be used to create and manipu-
       late windows of that class.  A window's class string is initialized to NULL when the window is created.

       For main windows, Tk automatically propagates the name and class to the WM_CLASS property used by window  managers.   This  happens  either
       when a main window is actually created (e.g. in Tk_MakeWindowExist), or when Tk_SetClass is called, whichever occurs later.  If a main win-
       dow has not been assigned a class then Tk will not set the WM_CLASS property for the window.

       Tk_Class is a macro that returns the current value of tkwin's class.  The value is returned as a Tk_Uid, which may  be  used  just  like  a
       string  pointer	but also has the properties of a unique identifier (see the manual entry for Tk_GetUid for details).  If tkwin has not yet
       been given a class, then Tk_Class will return NULL.

KEYWORDS

       class, unique identifier, 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_SetClass(3TK)