Tk_SetGrid(3) Tk (4.0) Tk_SetGrid(3)
_________________________________________________________________
NAME
Tk_SetGrid, Tk_UnsetGrid - control the grid for interactive
resizing
SYNOPSIS
#include <tk.h>
Tk_SetGrid(tkwin, reqWidth, reqHeight, widthInc, heightInc)
Tk_UnsetGrid(tkwin)
ARGUMENTS
Tk_Window tkwin (in) Token for window.
int reqWidth (in) Width in grid units that
corresponds to the pixel
dimension tkwin has
requested via
Tk_GeometryRequest.
int reqHeight (in) Height in grid units that
corresponds to the pixel
dimension tkwin has
requested via
Tk_GeometryRequest.
int widthInc (in) Width of one grid unit, in
pixels.
int heightInc (in) Height of one grid unit,
in pixels.
_________________________________________________________________
DESCRIPTION
Tk_SetGrid turns on gridded geometry management for tkwin's
toplevel window and specifies the geometry of the grid.
Tk_SetGrid is typically invoked by a widget when its setGrid
option is true. It restricts interactive resizing of
tkwin's toplevel window so that the space allocated to the
toplevel is equal to its requested size plus or minus even
multiples of widthInc and heightInc. Furthermore, the
reqWidth and reqHeight values are passed to the window
manager so that it can report the window's size in grid
units during interactive resizes. If tkwin's configuration
changes (e.g., the size of a grid unit changes) then the
widget should invoke Tk_SetGrid again with the new
information.
Tk_UnsetGrid cancels gridded geometry management for tkwin's
Page 1 (printed 2/26/99)
Tk_SetGrid(3) Tk (4.0) Tk_SetGrid(3)
toplevel window.
For each toplevel window there can be at most one internal
window with gridding enabled. If Tk_SetGrid or Tk_UnsetGrid
is invoked when some other window is already controlling
gridding for tkwin's toplevel, the calls for the new window
have no effect.
See the wm manual entry for additional information on
gridded geometry management.
KEYWORDS
grid, window, window manager
Page 2 (printed 2/26/99)
