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 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_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)