About Us Documentation

Contact Site Map




Tk_SetWindowVisual(3) Tk Library Procedures                   4.0



Tk_SetWindowVisual - change visual characteristics of window


#include <tk.h> int Tk_SetWindowVisual(tkwin, visual, depth, colormap)


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 compati- ble with visual and depth. _________________________________________________________________


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.


colormap, depth, visual Tk 1 Prepared by Ready-to-Run Software, Inc.


Email addresses listed on this site may  NOT be used for unsolicited commercial email.

Ready-to-Run Software, Inc Privacy Statement

Portions (c)Copyright, 1996-2005 by Ready-to-Run Software, Inc
(All rights reserved.)
212 Cedar Cove
Lansing, NY 14882
Phone: 607 533 UNIX (8649)
Fax: 607 533 4002

To return to the Ready-to-Run Software WinPak Table of contents please presshere