From 266476d32bd269461916703a6d90d910f9221b8d Mon Sep 17 00:00:00 2001 From: Tristan Van Berkom Date: Wed, 15 Sep 2010 03:54:12 +0900 Subject: [PATCH] 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. --- docs/reference/gtk/tmpl/gtksizegroup.sgml | 9 +++++++++ 1 file changed, 9 insertions(+) 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. + +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. + GtkSizeGroup as GtkBuildable