summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTristan Van Berkom <tristan.van.berkom@gmail.com>2010-09-15 03:54:12 +0900
committerTristan Van Berkom <tristan.van.berkom@gmail.com>2010-09-15 04:04:02 +0900
commit266476d32bd269461916703a6d90d910f9221b8d (patch)
tree5bb584ef56f947d6bc32da462af49ad925f439ea
parent8bfb1e0ab89a5d4c2e764e3b557a115834cb9678 (diff)
downloadgtk+-266476d32bd269461916703a6d90d910f9221b8d.tar.gz
Added documentation to gtksizegroup.sgml explaining what happens with height-for-width widgets.
When grouping height-for-width trading widgets (wrapping labels for instance) vertically; the height for the minimum width will always be used for the entire group... this patch warns about this in the docs.
-rw-r--r--docs/reference/gtk/tmpl/gtksizegroup.sgml9
1 files changed, 9 insertions, 0 deletions
diff --git a/docs/reference/gtk/tmpl/gtksizegroup.sgml b/docs/reference/gtk/tmpl/gtksizegroup.sgml
index 4bf90cec62..4d6329fbf1 100644
--- a/docs/reference/gtk/tmpl/gtksizegroup.sgml
+++ b/docs/reference/gtk/tmpl/gtksizegroup.sgml
@@ -44,6 +44,15 @@ vertical size from the vertical requisition of all widgets that can be
reached from the widget by a chain of size groups of type
%GTK_SIZE_GROUP_VERTICAL or %GTK_SIZE_GROUP_BOTH.
</para>
+<para>
+Note that only non-contextual sizes of every widget are ever consulted
+by size groups (since size groups have no knowledge of what size a widget
+will be allocated in one dimension, it cannot derive how much height
+a widget will receive for a given width). When grouping widgets that
+trade height for width in mode %GTK_SIZE_GROUP_VERTICAL or %GTK_SIZE_GROUP_BOTH:
+the height for the minimum width will be the requested height for all
+widgets in the group.
+</para>
<refsect2 id="GtkSizeGroup-BUILDER-UI">
<title>GtkSizeGroup as GtkBuildable</title>
<para>