Tk_SetGrid(3) Tk Library Procedures 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
Token for window. Width in grid units that corresponds to the pixel
dimension tkwin has requested via Tk_GeometryRequest. Height in grid
units that corresponds to the pixel dimension tkwin has requested via
Tk_GeometryRequest. Width of one grid unit, in pixels. 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 allo-
cated 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 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
Tk 4.0 Tk_SetGrid(3)
SetGrid 8.5.4 - Generated Sun Aug 24 15:15:12 CDT 2008