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