diff options
author | Tristan Van Berkom <tristan.van.berkom@gmail.com> | 2010-09-15 03:54:12 +0900 |
---|---|---|
committer | Tristan Van Berkom <tristan.van.berkom@gmail.com> | 2010-09-15 04:04:02 +0900 |
commit | 266476d32bd269461916703a6d90d910f9221b8d (patch) | |
tree | 5bb584ef56f947d6bc32da462af49ad925f439ea | |
parent | 8bfb1e0ab89a5d4c2e764e3b557a115834cb9678 (diff) | |
download | gtk+-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.sgml | 9 |
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> |