Tk_SetWindowVisual(3) Tk (4.0) 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 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
Page 1 (printed 2/26/99)