This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

Tk_SetClass(3)                              Tk Library Procedures                             Tk_SetClass(3)



____________________________________________________________________________________________________________

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 manipulate 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_MakeWin-dowExist), Tk_MakeWindowExist),
       dowExist), or when Tk_SetClass is called, whichever occurs later.  If a  main  window  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  identi-fier identifier
       fier (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



Tk                                                                                            Tk_SetClass(3)