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:
parent
0bca60fdd3
commit
e3957f559d
@ -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)->get_width(GTK_SIZE_REQUEST(widget), &min, &natural);
|
* GTK_WIDGET_GET_CLASS(widget)->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,
|
||||||
|
Loading…
Reference in New Issue
Block a user