Add long description

svn path=/trunk/; revision=22063
This commit is contained in:
Matthias Clasen 2009-01-05 04:19:48 +00:00
parent f4ee825f0e
commit e725c73ba0
2 changed files with 20 additions and 1 deletions

View File

@ -1,3 +1,10 @@
2009-01-04 Matthias Clasen <mclasen@redhat.com>
Bug 566045 GtkViewport is lacking a description
* gtk/tmpl/gtkviewport.sgml: Add some descriptive text, shamelessly
copied from gtkscrolledwindow.sgml. Requested by Andrew Cowie.
2009-01-01 Matthias Clasen <mclasen@redhat.com>
* === Released 2.15.0 ===

View File

@ -6,12 +6,24 @@ An adapter which makes widgets scrollable
<!-- ##### SECTION Long_Description ##### -->
<para>
The #GtkViewport widget acts as an adaptor class, implementing
scrollability for child widgets that lack their own scrolling
capabilities. Use #GtkViewport to scroll child widgets such as
#GtkTable, #GtkBox, and so on.
</para>
<para>
If a widget has native scrolling abilities, such as #GtkTextView,
#GtkTreeView or #GtkIconview, it can be added to a #GtkScrolledWindow
with gtk_container_add(). If a widget does not, you must first add the
widget to a #GtkViewport, then add the viewport to the scrolled window.
The convenience function gtk_scrolled_window_add_with_viewport() does
exactly this, so you can ignore the presence of the viewport.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GtkScrolledWindow, #GtkAdjustment
</para>
<!-- ##### SECTION Stability_Level ##### -->