Tcl/Tk Documentation > TkLib > ConfigWind
Tk_ConfigureWindow(tkwin, valueMask, valuePtr)
Tk_MoveWindow(tkwin, x, y)
Tk_ResizeWindow(tkwin, width, height)
Tk_MoveResizeWindow(tkwin, x, y, width, height)
Tk_ChangeWindowAttributes(tkwin, valueMask, attsPtr)
- Tk_Window tkwin (in)
- Token for window.
- unsigned int valueMask (in)
- OR-ed mask of values like CWX or CWBorderPixel, indicating which fields of *valuePtr or *attsPtr to use.
- XWindowChanges *valuePtr (in)
- Points to a structure containing new values for the configuration parameters selected by valueMask. Fields not selected by valueMask are ignored.
- int x (in)
- New x-coordinate for tkwin's top left pixel (including border, if any) within tkwin's parent.
- int y (in)
- New y-coordinate for tkwin's top left pixel (including border, if any) within tkwin's parent.
- int width (in)
- New width for tkwin (interior, not including border).
- int height (in)
- New height for tkwin (interior, not including border).
- int borderWidth (in)
- New width for tkwin's border.
- XSetWindowAttributes *attsPtr (in)
- Points to a structure containing new values for the attributes given by the valueMask argument. Attributes not selected by valueMask are ignored.
- unsigned long pixel (in)
- New background or border color for window.
- Pixmap pixmap (in)
- New pixmap to use for background or border of tkwin. WARNING: cannot necessarily be deleted immediately, as for Xlib calls. See note below.
- Colormap colormap (in)
- New colormap to use for tkwin.
- Tk_Cursor cursor (in)
- New cursor to use for tkwin. If None is specified, then tkwin will not have its own cursor; it will use the cursor of its parent.
See the X library documentation for details on what these procedures do and how they use their arguments.
In the procedures Tk_ConfigureWindow, Tk_MoveWindow, Tk_ResizeWindow, Tk_MoveResizeWindow, and Tk_SetWindowBorderWidth, if tkwin is an internal window then event handlers interested in configure events are invoked immediately, before the procedure returns. If tkwin is a top-level window then the event handlers will be invoked later, after X has seen the request and returned an event for it.
Applications using Tk should never call procedures like XConfigureWindow directly; they should always use the corresponding Tk procedures.
The size and location of a window should only be modified by the appropriate geometry manager for that window and never by a window itself (but see Tk_MoveToplevelWindow for moving a top-level window).
You may not use Tk_ConfigureWindow to change the stacking order of a window (valueMask may not contain the CWSibling or CWStackMode bits). To change the stacking order, use the procedure Tk_RestackWindow.
The procedure Tk_SetWindowColormap will automatically add tkwin to the TK_COLORMAP_WINDOWS property of its nearest top-level ancestor if the new colormap is different from that of tkwin's parent and tkwin is not already in the TK_COLORMAP_WINDOWS property.Tk_MakeWindowExist first to be sure that tkwin's window exists and pixmap has been passed to the X server.
A similar problem occurs for the cursor argument passed to Tk_DefineCursor. The solution is the same as for pixmaps above: call Tk_MakeWindowExist before freeing the cursor.Tk_MoveToplevelWindow, Tk_RestackWindow attributes, border, color, configure, height, pixel, pixmap, width, window, x, y