Tk_SetWindowVisual(3tk)

Tk_SetWindowVisual(3) Tk Library Procedures Tk_SetWindowVisual(3)

_________________________________________________________________

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 compati-
                                          ble  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 sig-
     nify 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

Tk                      Last change: 4.0                        1