Manual Pages for UNIX Operating System command usage for man Tk_Class

Tk Library Procedures                            Tk_SetClass(3TK)



_________________________________________________________________

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

SYNOPSIS
     #include 

     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  win-
     dows  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  proper-
     ties  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



Tk                        Last change:                          1






Tk Library Procedures                            Tk_SetClass(3TK)



     attributes:

     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tk-8   |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

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











































Tk                        Last change:                          2