TkSetGrid(3) Tk Library Procedures TkSetGrid(3)

NAME
       TkSetGrid, TkUnsetGrid - control the grid for interactive resizing

SYNOPSIS
       ##iinncclluuddee <>

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

       TTkkUUnnsseettGGrriidd(tkwin)

AARRGGUUMMEENNTTSS
       TkWindow   tkwin       (in)      Token for window.

       int         reqWidth    (in)      Width  in grid units that corresponds
                                         to  the  pixel  dimension  tkwin  has
                                         requested via TTkkGGeeoommeettrryyRReeqquueesstt.

       int         reqHeight   (in)      Height in grid units that corresponds
                                         to  the  pixel  dimension  tkwin  has
                                         requested via TTkkGGeeoommeettrryyRReeqquueesstt.

       int         widthInc    (in)      Width of one grid unit, in pixels.

       int         heightInc   (in)      Height of one grid unit, in pixels.



DESCRIPTION
       TTkkSSeettGGrriidd  turns  on  gridded geometry management for tkwin's toplevel
       window and specifies the geometry of the grid.  TTkkSSeettGGrriidd is typically
       invoked  by  a  widget  when  its sseettGGrriidd option is true.  It restricts
       interactive resizing of tkwin's toplevel window so that the space allo-
       cated 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 TTkkSSeettGGrriidd again with the new information.

       TTkkUUnnsseettGGrriidd 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 TTkkSSeettGGrriidd or TTkkUUnnsseettGGrriidd 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 wwmm manual entry for additional information on gridded  geometry
       management.


KKEEYYWWOORRDDSS
       grid, window, window manager



Tk                                    4.0                        TkSetGrid(3)