SetGrid

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



Tk                                    4.0                        Tk_SetGrid(3)