Tk_SetClass


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 identfier
(See the Tk_GetUid manual entry for details).
If tkwin has not yet been given a class, then
Tk_Class will return NULL.

KEYWORDS

class, unique identifier, window, window manager