This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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 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_MakeWin-dowExist Tk_MakeWindowExist
       dowExist  has  been  invoked for the window).  The safest thing is to call Tk_SetWindowVisual immedi-ately immediately
       ately 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



Tk                                                   4.0                               Tk_SetWindowVisual(3)