docs: Move documentation to inline comments: GtkLayout

Signed-off-by: Javier Jardón <jjardon@gnome.org>
This commit is contained in:
Garrett Regier 2010-11-06 17:28:53 +01:00 committed by Javier Jardón
parent a9a7b60898
commit 65536550c5
3 changed files with 22 additions and 177 deletions

View File

@ -20,6 +20,7 @@ gtkiconview.sgml
gtkimcontextsimple.sgml
gtkimmulticontext.sgml
gtkitemfactory.sgml
gtklayout.sgml
gtklinkbutton.sgml
gtkmessagedialog.sgml
gtknotebook.sgml

View File

@ -1,177 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkLayout
<!-- ##### SECTION Short_Description ##### -->
Infinite scrollable area containing child widgets and/or custom drawing
<!-- ##### SECTION Long_Description ##### -->
<para>
#GtkLayout is similar to #GtkDrawingArea in that it's a "blank slate"
and doesn't do anything but paint a blank background by default. It's
different in that it supports scrolling natively (you can add it to a
#GtkScrolledWindow), and it can contain child widgets, since it's a
#GtkContainer. However if you're just going to draw, a #GtkDrawingArea
is a better choice since it has lower overhead.
</para>
<para>
When handling expose events on a #GtkLayout, you must draw to
GTK_LAYOUT (layout)-&gt;bin_window, rather than to
GTK_WIDGET (layout)-&gt;window, as you would for a drawing
area.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GtkDrawingArea, #GtkScrolledWindow
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### STRUCT GtkLayout ##### -->
<para>
</para>
<!-- ##### SIGNAL GtkLayout::set-scroll-adjustments ##### -->
<para>
</para>
@layout: the object which received the signal.
@arg1:
@arg2:
<!-- ##### ARG GtkLayout:hadjustment ##### -->
<para>
</para>
<!-- ##### ARG GtkLayout:height ##### -->
<para>
</para>
<!-- ##### ARG GtkLayout:vadjustment ##### -->
<para>
</para>
<!-- ##### ARG GtkLayout:width ##### -->
<para>
</para>
<!-- ##### ARG GtkLayout:x ##### -->
<para>
</para>
<!-- ##### ARG GtkLayout:y ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_layout_new ##### -->
<para>
</para>
@hadjustment:
@vadjustment:
@Returns:
<!-- ##### FUNCTION gtk_layout_put ##### -->
<para>
</para>
@layout:
@child_widget:
@x:
@y:
<!-- ##### FUNCTION gtk_layout_move ##### -->
<para>
</para>
@layout:
@child_widget:
@x:
@y:
<!-- ##### FUNCTION gtk_layout_set_size ##### -->
<para>
</para>
@layout:
@width:
@height:
<!-- ##### FUNCTION gtk_layout_get_size ##### -->
<para>
</para>
@layout:
@width:
@height:
<!-- ##### FUNCTION gtk_layout_get_hadjustment ##### -->
<para>
</para>
@layout:
@Returns:
<!-- ##### FUNCTION gtk_layout_get_vadjustment ##### -->
<para>
</para>
@layout:
@Returns:
<!-- ##### FUNCTION gtk_layout_set_hadjustment ##### -->
<para>
</para>
@layout:
@adjustment:
<!-- ##### FUNCTION gtk_layout_set_vadjustment ##### -->
<para>
</para>
@layout:
@adjustment:
<!-- ##### FUNCTION gtk_layout_get_bin_window ##### -->
<para>
</para>
@layout:
@Returns:

View File

@ -40,6 +40,27 @@
#include "gtkscrollable.h"
/**
* SECTION:gtklayout
* @Short_description: Infinite scrollable area containing child widgets
* and/or custom drawing
* @Title: GtkLayout
* @See_also: #GtkDrawingArea, #GtkScrolledWindow
*
* #GtkLayout is similar to #GtkDrawingArea in that it's a "blank slate"
* and doesn't do anything but paint a blank background by default. It's
* different in that it supports scrolling natively (you can add it to a
* #GtkScrolledWindow), and it can contain child widgets, since it's a
* #GtkContainer. However if you're just going to draw, a #GtkDrawingArea
* is a better choice since it has lower overhead.
*
* When handling expose events on a #GtkLayout, you must draw to
* GTK_LAYOUT (layout)->bin_window, rather than to
* GTK_WIDGET (layout)->window, as you would for a drawing
* area.
*/
typedef struct _GtkLayoutChild GtkLayoutChild;
struct _GtkLayoutPrivate