This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

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 geome-try geometry
       try 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_Set-Grid Tk_SetGrid
       Grid 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)