AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-19 01:40:10 +00:00
Code Issues Projects Releases Wiki Activity

docs: Improve reference crossing in GtkWidget docs

Browse Source
This commit is contained in:
Javier Jardón 2010-10-11 04:59:19 +02:00
parent 71b4d83144
commit cabc386252
1 changed files with 6 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
gtk/gtkwidget.c
View File

@ -113,15 +113,16 @@
* *
* A widget that does not actually do height-for-width * A widget that does not actually do height-for-width
* or width-for-height size negotiations only has to implement * or width-for-height size negotiations only has to implement
* get_preferred_width() and get_preferred_height(). * #GtkWidgetClass.get_preferred_width() and
* #GtkWidgetClass.get_preferred_height().
* *
* If a widget does move content around to smartly use up the * If a widget does move content around to smartly use up the
* allocated size, then it must support the request properly in * allocated size, then it must support the request properly in
* both orientations; even if the request only makes sense in * both orientations; even if the request only makes sense in
* one orientation. * one orientation.
* *
* For instance, a GtkLabel that does height-for-width word wrapping * For instance, a #GtkLabel that does height-for-width word wrapping
* will not expect to have get_preferred_height() called because that * will not expect to have #GtkWidgetClass.get_preferred_height() called because that
* call is specific to a width-for-height request. In this case the * call is specific to a width-for-height request. In this case the
* label must return the heights contextual to its minimum possible * label must return the heights contextual to its minimum possible
* width. By following this rule any widget that handles height-for-width * width. By following this rule any widget that handles height-for-width
@ -143,7 +144,7 @@
* It will not work to use the wrapper functions, such as * It will not work to use the wrapper functions, such as
* gtk_widget_get_preferred_width(), inside your own size request * gtk_widget_get_preferred_width(), inside your own size request
* implementation. These return a request adjusted by #GtkSizeGroup * implementation. These return a request adjusted by #GtkSizeGroup
* and by the GtkWidgetClass::adjust_size_request virtual method. If a * and by the #GtkWidgetClass.adjust_size_request() virtual method. If a
* widget used the wrappers inside its virtual method implementations, * widget used the wrappers inside its virtual method implementations,
* then the adjustments (such as widget margins) would be applied * then the adjustments (such as widget margins) would be applied
* twice. GTK+ therefore does not allow this and will warn if you try * twice. GTK+ therefore does not allow this and will warn if you try
@ -157,6 +158,7 @@
* </para> * </para>
* </refsect2> * </refsect2>
* <refsect2 id="style-properties"> * <refsect2 id="style-properties">
* <title>Style Properties</title>
* <para> * <para>
* <structname>GtkWidget</structname> introduces <firstterm>style * <structname>GtkWidget</structname> introduces <firstterm>style
* properties</firstterm> - these are basically object properties that are stored * properties</firstterm> - these are basically object properties that are stored