setvisual(3Tk)

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 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
     colormap, depth, visual