Provided by: tk8.6-doc_8.6.13-2_all bug

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_MakeWindowExist), 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 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