callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Move documentation to inline comments: GtkFrame

Browse Source
This commit is contained in:
Javier Jardón
2011-04-13 00:49:30 +01:00
parent 1263fdbd67
commit 7f504fdfa0
4 changed files with 56 additions and 160 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/reference/gtk/tmpl/.gitignore vendored
View File

@ -37,6 +37,7 @@ gtkfixed.sgml
gtkfilechooserwidget.sgml
gtkfilefilter.sgml
gtkfontbutton.sgml
gtkframe.sgml
gtkhbox.sgml
gtkhpaned.sgml
gtkhscale.sgml

160
docs/reference/gtk/tmpl/gtkframe.sgml
View File

@ -1,160 +0,0 @@
<!-- ##### SECTION Title ##### -->
GtkFrame
<!-- ##### SECTION Short_Description ##### -->
A bin with a decorative frame and optional label
<!-- ##### SECTION Long_Description ##### -->
<para>
The frame widget is a Bin that surrounds its child
with a decorative frame and an optional label.
If present, the label is drawn in a gap in the
top side of the frame. The position of the
label can be controlled with gtk_frame_set_label_align().
</para>
<refsect2 id="GtkFrame-BUILDER-UI">
<title>GtkFrame as GtkBuildable</title>
<para>
The GtkFrame implementation of the GtkBuildable interface
supports placing a child in the label position by specifying
"label" as the "type" attribute of a &lt;child&gt; element.
A normal content child can be specified without specifying
a &lt;child&gt; type attribute.
</para>
<example>
<title>A UI definition fragment with GtkFrame</title>
<programlisting><![CDATA[
<object class="GtkFrame">
<child type="label">
<object class="GtkLabel" id="frame-label"/>
</child>
<child>
<object class="GtkEntry" id="frame-content"/>
</child>
</object>
]]></programlisting>
</example>
</refsect2>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### STRUCT GtkFrame ##### -->
<para>
</para>
<!-- ##### ARG GtkFrame:label ##### -->
<para>
</para>
<!-- ##### ARG GtkFrame:label-widget ##### -->
<para>
</para>
<!-- ##### ARG GtkFrame:label-xalign ##### -->
<para>
</para>
<!-- ##### ARG GtkFrame:label-yalign ##### -->
<para>
</para>
<!-- ##### ARG GtkFrame:shadow-type ##### -->
<para>
</para>
<!-- ##### FUNCTION gtk_frame_new ##### -->
<para>
</para>
@label:
@Returns:
<!-- ##### FUNCTION gtk_frame_set_label ##### -->
<para>
</para>
@frame:
@label:
<!-- ##### FUNCTION gtk_frame_set_label_widget ##### -->
<para>
</para>
@frame:
@label_widget:
<!-- ##### FUNCTION gtk_frame_set_label_align ##### -->
<para>
</para>
@frame:
@xalign:
@yalign:
<!-- ##### FUNCTION gtk_frame_set_shadow_type ##### -->
<para>
</para>
@frame:
@type:
<!-- ##### FUNCTION gtk_frame_get_label ##### -->
<para>
</para>
@frame:
@Returns:
<!-- ##### FUNCTION gtk_frame_get_label_align ##### -->
<para>
</para>
@frame:
@xalign:
@yalign:
<!-- ##### FUNCTION gtk_frame_get_label_widget ##### -->
<para>
</para>
@frame:
@Returns:
<!-- ##### FUNCTION gtk_frame_get_shadow_type ##### -->
<para>
</para>
@frame:
@Returns:

18
docs/reference/gtk/tmpl/gtkmenuitem.sgml
View File

@ -324,3 +324,21 @@ Emits the "toggle_size_allocate" signal on the given item.
@allocation: the allocation to use as signal data.
<!-- ##### FUNCTION gtk_menu_item_get_reserve_indicator ##### -->
<para>
</para>
@menu_item:
@Returns:
<!-- ##### FUNCTION gtk_menu_item_set_reserve_indicator ##### -->
<para>
</para>
@menu_item:
@reserve:

37
gtk/gtkframe.c
View File

@ -34,6 +34,43 @@
#include "gtkbuildable.h"
/**
* SECTION:gtkframe
* @Short_description: A bin with a decorative frame and optional label
* @Title: GtkFrame
*
* The frame widget is a Bin that surrounds its child
* with a decorative frame and an optional label.
* If present, the label is drawn in a gap in the
* top side of the frame. The position of the
* label can be controlled with gtk_frame_set_label_align().
*
* <refsect2 id="GtkFrame-BUILDER-UI">
* <title>GtkFrame as GtkBuildable</title>
* <para>
* The GtkFrame implementation of the GtkBuildable interface
* supports placing a child in the label position by specifying
* "label" as the "type" attribute of a &lt;child&gt; element.
* A normal content child can be specified without specifying
* a &lt;child&gt; type attribute.
* </para>
* <example>
* <title>A UI definition fragment with GtkFrame</title>
* <programlisting><![CDATA[
* <object class="GtkFrame">
* <child type="label">
* <object class="GtkLabel" id="frame-label"/>
* </child>
* <child>
* <object class="GtkEntry" id="frame-content"/>
* </child>
* </object>
* ]]></programlisting>
* </example>
* </refsect2>
*/
#define LABEL_PAD 1
#define LABEL_SIDE_PAD 2