GTK docs: Update width-for-height docs

Some places did not get updated after the recent rename-and-GtkWidget-merge.
This commit is contained in:
Matthias Clasen 2010-10-01 13:10:35 -04:00
parent 0bca60fdd3
commit e3957f559d

View File

@ -25,9 +25,9 @@
/** /**
* SECTION:gtksizerequest * SECTION:gtksizerequest
* @Short_Description: Height-for-width geometry management * @Short_Description: Height-for-width geometry management
* @Title: GtkWidget * @Title: GtkWidget
* *
* The GtkWidget interface is GTK+'s height-for-width (and width-for-height) * The GtkWidget interface is GTK+'s height-for-width (and width-for-height)
* geometry management system. Height-for-width means that a widget can * geometry management system. Height-for-width means that a widget can
* change how much vertical space it needs, depending on the amount * change how much vertical space it needs, depending on the amount
* of horizontal space that it is given (and similar for width-for-height). * of horizontal space that it is given (and similar for width-for-height).
@ -36,14 +36,14 @@
* *
* GTK+'s traditional two-pass <link linkend="size-allocation">size-allocation</link> * GTK+'s traditional two-pass <link linkend="size-allocation">size-allocation</link>
* algorithm does not allow this flexibility. #GtkWidget provides a default * algorithm does not allow this flexibility. #GtkWidget provides a default
* implementation of the #GtkWidget interface for existing widgets, * implementation of the #GtkWidget interface for existing widgets,
* which always requests the same height, regardless of the available width. * which always requests the same height, regardless of the available width.
* *
* <refsect2> * <refsect2>
* <title>Implementing GtkWidget </title> * <title>Implementing GtkWidget</title>
* <para> * <para>
* Some important things to keep in mind when implementing * Some important things to keep in mind when implementing
* the GtkWidget interface and when using it in container * the GtkWidget interface and when using it in container
* implementations. * implementations.
* *
* The geometry management system will query a logical hierarchy in * The geometry management system will query a logical hierarchy in
@ -67,13 +67,13 @@
* *
* That means that the request operation at allocation time will * That means that the request operation at allocation time will
* usually fire again in contexts of different allocated sizes than * usually fire again in contexts of different allocated sizes than
* the ones originally queried for. #GtkWidget caches a * the ones originally queried for. #GtkWidget caches a
* small number of results to avoid re-querying for the same * small number of results to avoid re-querying for the same
* allocated size in one allocation cycle. * allocated size in one allocation cycle.
* *
* 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_width() and get_height(). * get_preferred_width() and 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
@ -81,7 +81,7 @@
* 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_height() called because that * will not expect to have 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
@ -96,12 +96,12 @@
* <example> * <example>
* <title>Widget calling its own size request method.</title> * <title>Widget calling its own size request method.</title>
* <programlisting> * <programlisting>
* GTK_SIZE_REQUEST_GET_IFACE(widget)-&gt;get_width(GTK_SIZE_REQUEST(widget), &min, &natural); * GTK_WIDGET_GET_CLASS(widget)-&gt;get_preferred_width (widget), &min, &natural);
* </programlisting> * </programlisting>
* </example> * </example>
* *
* It will not work to use the wrapper functions, such as * It will not work to use the wrapper functions, such as
* gtk_size_request_get_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,