AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-12-25 21:21:21 +00:00
Code Issues Projects Releases Wiki Activity

[docs] Move documentation to inline comments: GtkViewport

Browse Source 
Fixes https://bugzilla.gnome.org/show_bug.cgi?id=611829x

Signed-off-by: Javier Jardón <jjardon@gnome.org>
This commit is contained in:
Steven Harms 2010-03-04 13:13:45 -05:00 committed by Javier Jardón
parent 75ffa7983a
commit 7693026e44
2 changed files with 19 additions and 134 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

134
docs/reference/gtk/tmpl/gtkviewport.sgml
View File

@ -1,134 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkViewport
<!-- ##### SECTION Short_Description ##### -->
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 ##### -->
<!-- ##### STRUCT GtkViewport ##### -->
<para>
</para>
<!-- ##### SIGNAL GtkViewport::set-scroll-adjustments ##### -->
<para>
</para>
@viewport: the object which received the signal.
@arg1:
@arg2:
<!-- ##### ARG GtkViewport:hadjustment ##### -->
<para>
</para>
<!-- ##### ARG GtkViewport:shadow-type ##### -->
<para>
</para>
<!-- ##### ARG GtkViewport:vadjustment ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_viewport_new ##### -->
<para>
</para>
@hadjustment:
@vadjustment:
@Returns:
<!-- ##### FUNCTION gtk_viewport_get_hadjustment ##### -->
<para>
</para>
@viewport:
@Returns:
<!-- ##### FUNCTION gtk_viewport_get_vadjustment ##### -->
<para>
</para>
@viewport:
@Returns:
<!-- ##### FUNCTION gtk_viewport_set_hadjustment ##### -->
<para>
</para>
@viewport:
@adjustment:
<!-- ##### FUNCTION gtk_viewport_set_vadjustment ##### -->
<para>
</para>
@viewport:
@adjustment:
<!-- ##### FUNCTION gtk_viewport_set_shadow_type ##### -->
<para>
</para>
@viewport:
@type:
<!-- ##### FUNCTION gtk_viewport_get_shadow_type ##### -->
<para>
</para>
@viewport:
@Returns:
<!-- ##### FUNCTION gtk_viewport_get_bin_window ##### -->
<para>
</para>
@viewport:
@Returns:

19
gtk/gtkviewport.c
View File

@ -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,