opensolaris man page for tk_setwindowvisual

Tk_SetWindowVisual(3TK) 				       Tk Library Procedures					   Tk_SetWindowVisual(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_SetWin-
       dowVisual 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

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tk is available on http://opensolaris.org.

Tk									4.0						   Tk_SetWindowVisual(3TK)