Scroll to navigation

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







  

    4.0
    Tk