[gtk+] Move documentation to inline comments: GtkCellRendererCombo



commit 3990af227f5f14b41855a019bba69873687c2172
Author: Javier Jardón <jjardon gnome org>
Date:   Mon Apr 11 22:39:48 2011 +0100

    Move documentation to inline comments: GtkCellRendererCombo

 docs/reference/gtk/tmpl/.gitignore                |    1 +
 docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml |   78 ---------------------
 gtk/gtkcellrenderercombo.c                        |   21 ++++++
 3 files changed, 22 insertions(+), 78 deletions(-)
---
diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index 227c486..7bfa2cc 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -12,6 +12,7 @@ gtkcelleditable.sgml
 gtkcelllayout.sgml
 gtkcellrenderer.sgml
 gtkcellrendereraccel.sgml
+gtkcellrenderercombo.sgml
 gtkcellrendererprogress.sgml
 gtkcellrendererspin.sgml
 gtkcellrenderertext.sgml
diff --git a/gtk/gtkcellrenderercombo.c b/gtk/gtkcellrenderercombo.c
index ad154c4..d14908a 100644
--- a/gtk/gtkcellrenderercombo.c
+++ b/gtk/gtkcellrenderercombo.c
@@ -30,6 +30,27 @@
 #include "gtkmarshalers.h"
 #include "gtkprivate.h"
 
+
+/**
+ * SECTION:gtkcellrenderercombo
+ * @Short_description: Renders a combobox in a cell
+ * @Title: GtkCellRendererCombo
+ *
+ * #GtkCellRendererCombo renders text in a cell like #GtkCellRendererText from
+ * which it is derived. But while #GtkCellRendererText offers a simple entry to
+ * edit the text, #GtkCellRendererCombo offers a #GtkComboBox or #GtkComboBoxEntry
+ * widget to edit the text. The values to display in the combo box are taken from
+ * the tree model specified in the #GtkCellRendererCombo:model property.
+ *
+ * The combo cell renderer takes care of adding a text cell renderer to the combo
+ * box and sets it to display the column specified by its
+ * #GtkCellRendererCombo:text-column property. Further properties of the comnbo box
+ * can be set in a handler for the #GtkCellRenderer::editing-started signal.
+ *
+ * The #GtkCellRendererCombo cell renderer was added in GTK+ 2.6.
+ */
+
+
 struct _GtkCellRendererComboPrivate
 {
   GtkTreeModel *model;



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]