NAME

       Tk_SetWindowVisual - change visual characteristics of window

SYNOPSIS

       #include <tk.h>

       int
       Tk_SetWindowVisual(tkwin, visual, depth, colormap)

ARGUMENTS

       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

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

       colormap, depth, visual