summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorpspjuth <peter.spjuth@gmail.com>2004-01-09 22:23:26 (GMT)
committerpspjuth <peter.spjuth@gmail.com>2004-01-09 22:23:26 (GMT)
commit40a16e5078cf54645c8dbc056c6667d80657f91c (patch)
treebcc85547dddf9359f1fcf1e1f07c20c313763041 /doc
parent46eead19d1ac38c3bcc59c7b24ab3a621b29eb3b (diff)
downloadtk-40a16e5078cf54645c8dbc056c6667d80657f91c.zip
tk-40a16e5078cf54645c8dbc056c6667d80657f91c.tar.gz
tk-40a16e5078cf54645c8dbc056c6667d80657f91c.tar.bz2
Implementation of TIP#146,
"Add Overall Anchoring to the Grid Geometry Manager", adding [grid anchor] subcommand.
Diffstat (limited to 'doc')
-rw-r--r--doc/grid.n17
1 files changed, 14 insertions, 3 deletions
diff --git a/doc/grid.n b/doc/grid.n
index 07c1ddd..b2790e9 100644
--- a/doc/grid.n
+++ b/doc/grid.n
@@ -4,7 +4,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: grid.n,v 1.6 2003/09/18 18:22:22 pspjuth Exp $
+'\" RCS: @(#) $Id: grid.n,v 1.7 2004/01/09 22:23:26 pspjuth Exp $
'\"
.so man.macros
.TH grid n 8.5 Tk "Tk Built-In Commands"
@@ -31,6 +31,13 @@ starting with \fB.\fP) or one of the characters \fBx\fP or \fB^\fP
(see the ``RELATIVE PLACEMENT'' section below), then the command is
processed in the same way as \fBgrid configure\fR.
.TP
+.VS 8.5
+\fBgrid anchor \fImaster\fR ?\fIanchor\fR?
+The anchor value controls how to place the grid within the master
+when no row/column has any weight. See ``THE GRID ALGORITHM'' below
+for further details. The default \fIanchor\fR is \fInw\fR.
+.VE
+.TP
\fBgrid bbox \fImaster\fR ?\fIcolumn row\fR? ?\fIcolumn2 row2\fR?
With no arguments,
the bounding box (in pixels) of the grid is returned.
@@ -333,15 +340,19 @@ minimum size. For example, if all rows or columns in a group have the
same weight, then each row or column will have the same size as the
largest row or column in the group.
.PP
+
+.VS 8.5
For masters whose size is larger than the requested layout, the additional
space is apportioned according to the row and column weights. If all of
-the weights are zero, the layout is centered within its master.
+the weights are zero, the layout is placed within its master according to
+the \fIanchor\fR value.
For masters whose size is smaller than the requested layout, space is taken
away from columns and rows according to their weights. However, once a
column or row shrinks to its minsize, its weight is taken to be zero.
If more space needs to be removed from a layout than would be permitted, as
when all the rows or columns are at there minimum sizes, the layout is
-clipped on the bottom and right.
+placed and clipped according to the \fIanchor\fR value.
+.VE
.SH "GEOMETRY PROPAGATION"
.PP
The grid geometry manager normally computes how large a master must be to