diff options
author | Matthias Clasen <mclasen@redhat.com> | 2014-02-02 00:29:00 -0500 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2014-02-02 00:30:27 -0500 |
commit | 09d1b28249af38448be0b52d00dd9924adac5d1c (patch) | |
tree | 9a303e4d610a4b3c5ab71e7155f021807f1b43fe /gtk/gtkcelllayout.c | |
parent | 16e38946bdd3ee69d76f658afbfee272af1f52ab (diff) | |
download | gtk+-09d1b28249af38448be0b52d00dd9924adac5d1c.tar.gz |
docs: Convert to markdown
Specifically, switch to using markdown syntax for sections.
Diffstat (limited to 'gtk/gtkcelllayout.c')
-rw-r--r-- | gtk/gtkcelllayout.c | 54 |
1 files changed, 23 insertions, 31 deletions
diff --git a/gtk/gtkcelllayout.c b/gtk/gtkcelllayout.c index 1bd5070f48..777a32cd38 100644 --- a/gtk/gtkcelllayout.c +++ b/gtk/gtkcelllayout.c @@ -21,22 +21,21 @@ * @Title: GtkCellLayout * * #GtkCellLayout is an interface to be implemented by all objects which - * want to provide a #GtkTreeViewColumn<!-- -->-like API for packing cells, setting - * attributes and data funcs. + * want to provide a #GtkTreeViewColumn like API for packing cells, + * setting attributes and data funcs. * - * One of the notable features provided by implementations of GtkCellLayout - * are attributes. Attributes let you set the properties + * One of the notable features provided by implementations of + * GtkCellLayout are attributes. Attributes let you set the properties * in flexible ways. They can just be set to constant values like regular * properties. But they can also be mapped to a column of the underlying * tree model with gtk_cell_layout_set_attributes(), which means that the value - * of the attribute can change from cell to cell as they are rendered by the - * cell renderer. Finally, it is possible to specify a function with - * gtk_cell_layout_set_cell_data_func() that is called to determine the value - * of the attribute for each cell that is rendered. - * - * <refsect2 id="GtkCellLayout-BUILDER-UI"> - * <title>GtkCellLayouts as GtkBuildable</title> - * <para> + * of the attribute can change from cell to cell as they are rendered by + * the cell renderer. Finally, it is possible to specify a function with + * gtk_cell_layout_set_cell_data_func() that is called to determine the + * value of the attribute for each cell that is rendered. + * + * ## GtkCellLayouts as GtkBuildable + * * Implementations of GtkCellLayout which also implement the GtkBuildable * interface (#GtkCellView, #GtkIconView, #GtkComboBox, * #GtkEntryCompletion, #GtkTreeViewColumn) accept GtkCellRenderer objects @@ -46,8 +45,7 @@ * a name attribute which specifies a property of the cell renderer; the * content of the element is the attribute value. * - * <example> - * <title>A UI definition fragment specifying attributes</title> + * This is an example of a UI definition fragment specifying attributes: * |[ * <object class="GtkCellView"> * <child> @@ -58,15 +56,15 @@ * </child>" * </object> * ]| - * </example> - * - * Furthermore for implementations of GtkCellLayout that use a #GtkCellArea - * to lay out cells (all GtkCellLayouts in GTK+ use a GtkCellArea) - * <link linkend="cell-properties">cell properties</link> can also be defined - * in the format by specifying the custom <cell-packing> attribute which - * can contain multiple <property> elements defined in the normal way. - * <example> - * <title>A UI definition fragment specifying cell properties</title> + * + * Furthermore for implementations of GtkCellLayout that use a + * #GtkCellArea to lay out cells (all GtkCellLayouts in GTK+ use + * a GtkCellArea) <link linkend="cell-properties">cell properties</link> + * can also be defined in the format by specifying the custom + * <cell-packing> attribute which can contain multiple + * <property> elements defined in the normal way. + * + * Here is a UI definition fragment specifying cell properties: * |[ * <object class="GtkTreeViewColumn"> * <child> @@ -78,13 +76,9 @@ * </child>" * </object> * ]| - * </example> - * </para> - * </refsect2> * - * <refsect2> - * <title>Subclassing GtkCellLayout implementations</title> - * <para> + * ## Subclassing GtkCellLayout implementations + * * When subclassing a widget that implements #GtkCellLayout like * #GtkIconView or #GtkComboBox, there are some considerations related * to the fact that these widgets internally use a #GtkCellArea. @@ -128,8 +122,6 @@ * to support alternative cell areas, you can do so by moving the * problematic calls out of init() and into a constructor() * for your class. - * </para> - * </refsect2> */ #include "config.h" |