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