Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 characteris-
     tics (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 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_SetWindow-
     Colormap instead.

KEYWORDS
     colormap, depth, visual

Tk				       4.0		   Tk_SetWindowVisual(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_SetWindowVisual.tk86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help