Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 resiz-
     ing 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  win-
     dow.

     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 man-
     agement.

KEYWORDS
     grid, window, window manager

Tk				       4.0			   Tk_SetGrid(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=Tk_SetGrid.tk86&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help