NAME

       Tk_SetWindowVisual - change visual characteristics of win­
       dow


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  doesn't  make  any changes;  otherwise it
       returns 1 to signify that the operation completed success­
       fully.

       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