Provided by: tk8.6-doc_8.6.13-2_all bug

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