diff options
Diffstat (limited to 'gtk/gtkviewport.c')
| -rw-r--r-- | gtk/gtkviewport.c | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/gtk/gtkviewport.c b/gtk/gtkviewport.c index bfda9f28bf..7571a5dcf3 100644 --- a/gtk/gtkviewport.c +++ b/gtk/gtkviewport.c @@ -31,6 +31,25 @@ #include "gtkprivate.h" #include "gtkalias.h" +/** + * SECTION:gtkviewport + * @Short_description: An adapter which makes widgets scrollable + * @Title: GtkViewport + * @See_also:#GtkScrolledWindow, #GtkAdjustment + * + * 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. + * + * 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. + */ + enum { PROP_0, PROP_HADJUSTMENT, |