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  re-
					 quested via Tk_GeometryRequest.

       int reqHeight (in)		 Height	in grid	units that corresponds
					 to the	pixel dimension	tkwin has  re-
					 quested 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 in-
       teractive 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 re-
       qHeight	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_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

Tk				      4.0			 Tk_SetGrid(3)

NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | KEYWORDS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=Tk_SetGrid.tk85&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help