Tk_SetWindowVisual(3Tk)				       Tk_SetWindowVisual(3Tk)

NAME    [Toc]    [Back]

     Tk_SetWindowVisual	- change visual	characteristics	of window

SYNOPSIS    [Toc]    [Back]

     #include <tk.h>

     int
     Tk_SetWindowVisual(tkwin, visual, depth, colormap)

ARGUMENTS    [Toc]    [Back]

     Tk_Window	     tkwin	(in)	  Token	for window.

     Visual	     *visual	(in)	  New visual type to use for tkwin.

     int	     depth	(in)	  Number of bits per pixel desired for
					  tkwin.

     Colormap	     colormap	(in)	  New colormap for tkwin, which	must
					  be compatible	with visual and	depth.

DESCRIPTION    [Toc]    [Back]

     When Tk creates a new window it assigns it	the default visual
     characteristics (visual, depth, and colormap) for its screen.
     Tk_SetWindowVisual	may be called to change	them.  Tk_SetWindowVisual must
     be	called before the window has actually been created in X	(e.g. before
     Tk_MapWindow or Tk_MakeWindowExist	has been invoked for the window).  The
     safest thing is to	call Tk_SetWindowVisual	immediately after calling
     Tk_CreateWindow.  If tkwin	has already been created before
     Tk_SetWindowVisual	is called then it returns 0 and	doesn't	make any
     changes;  otherwise it returns 1 to signify that the operation completed
     successfully.

     Note:  Tk_SetWindowVisual should not be called if you just	want to	change
     a window's	colormap without changing its visual or	depth; call
     Tk_SetWindowColormap instead.

KEYWORDS    [Toc]    [Back]

     colormap, depth, visual


									PPPPaaaaggggeeee 1111