Tk_SetGrid(3tk)

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

Tk                      Last change: 4.0                        1

Tk_SetGrid(3)         Tk Library Procedures         Tk_SetGrid(3)

     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  grid-
     ded geometry management.

KEYWORDS

     grid, window, window manager

Tk                      Last change: 4.0                        2