Manual Pages for UNIX Operating System command usage for man Tk_SetWindowVisual

Tk Library Procedures                     Tk_SetWindowVisual(3TK)



_________________________________________________________________

NAME
     Tk_SetWindowVisual - change visual characteristics of window

SYNOPSIS
     #include 

     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
     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  attri-
     butes:



Tk                      Last change: 4.0                        1






Tk Library Procedures                     Tk_SetWindowVisual(3TK)



     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|__________________|_
    | Availability       |  runtime/tk-8   |
    |____________________|__________________|_
    | Interface Stability|  Uncommitted    |
    |____________________|_________________|

NOTES
     Source for Tk is available on http://opensolaris.org.













































Tk                      Last change: 4.0                        2