Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 win-
     dow'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_Set-
     Class is called, whichever occurs later.  If a main window has not been as-
     signed 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

Tk								  Tk_SetClass(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_SetClass.tk86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help