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 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

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+14.3.quarterly>

home | help