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  charac-
       teristics  (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 call-
       ing  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  com-
       pleted 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)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | KEYWORDS

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

home | help