opensolaris man page for tk_unsetgrid

Tk_SetGrid(3TK) 					       Tk Library Procedures						   Tk_SetGrid(3TK)

__________________________________________________________________________________________________________________________________________________

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 typi-
       cally 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_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

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWTk	      |
       +--------------------+-----------------+
       |Interface Stability | Uncommitted     |
       +--------------------+-----------------+
NOTES
       Source for Tk is available on http://opensolaris.org.

Tk									4.0							   Tk_SetGrid(3TK)