Tk_SetWindowVisual - change visual characteristics of window
#include <tk.h> int Tk_SetWindowVisual(tkwin, visual, depth, colormap)
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 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
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | runtime/tk-8 |
+---------------+------------------+
|Stability | Uncommitted |
+---------------+------------------+
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
This software was built from source available at
https://github.com/oracle/solaris-userland. The original community
source was downloaded from https://source-
forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download.
Further information about this software can be found on the open source
community website at https://www.tcl.tk/.
Tk 4.0 Tk_SetWindowVisual(3tk)