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
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 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_SetWindowColormap instead.

KEYWORDS

colormap, depth, visual

Tk 4.0 Tk_SetWindowVisual(3)