MAN page from Old RedHat 5.X tk-8.0.2-16.i386.rpm

Tk_SetClass

Section: Tk Library Procedures (3)
Updated:
Index

NAME

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

SYNOPSIS

#include <tk.h>Tk_SetClass(tkwin, class)Tk_UidTk_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 particularwindow. The class string identifies the type of thewindow; all windows with the same general class of behavior(button, menu, etc.) should have the same class. Byconvention all class names start with a capital letter, andthere exists a Tcl command with the same name aseach class (except all in lower-case) which can be used tocreate and manipulate windows of that class.A window's class string is initialized to NULLwhen the window is created.

For main windows, Tk automatically propagates the name and classto the WM_CLASS property used by window managers. This happenseither when a main window is actually created (e.g. inTk_MakeWindowExist), or when Tk_SetClassis called, whichever occurs later. If a main window has not beenassigned a class then Tk will not set the WM_CLASS property forthe window.

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

KEYWORDS

class, unique identifier, window, window manager

This document was created byman2html,using the manual pages.