SetGrid






____________________________________________________________

Tk_SetGrid, Tk_UnsetGrid − control the grid for interactive
resizing


#include <tk.h>

Tk_SetGrid(tkwin, reqWidth, reqHeight, widthInc, heightInc)

Tk_UnsetGrid(tkwin)

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.
____________________________________________________________




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












                             ‐2‐


grid, window, window manager