diff --git a/ChangeLog b/ChangeLog index 595c428e1c..4b564ba8fd 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,5 +1,8 @@ 2004-11-02 Matthias Clasen + * gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init): + Doc additions. + * gtk/gtkfilechooserbutton.h: Fix trigraphs in private markers. * gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init): diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10 index 595c428e1c..4b564ba8fd 100644 --- a/ChangeLog.pre-2-10 +++ b/ChangeLog.pre-2-10 @@ -1,5 +1,8 @@ 2004-11-02 Matthias Clasen + * gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init): + Doc additions. + * gtk/gtkfilechooserbutton.h: Fix trigraphs in private markers. * gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init): diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6 index 595c428e1c..4b564ba8fd 100644 --- a/ChangeLog.pre-2-6 +++ b/ChangeLog.pre-2-6 @@ -1,5 +1,8 @@ 2004-11-02 Matthias Clasen + * gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init): + Doc additions. + * gtk/gtkfilechooserbutton.h: Fix trigraphs in private markers. * gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init): diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8 index 595c428e1c..4b564ba8fd 100644 --- a/ChangeLog.pre-2-8 +++ b/ChangeLog.pre-2-8 @@ -1,5 +1,8 @@ 2004-11-02 Matthias Clasen + * gtk/gtkcellrenderercombo.c (gtk_cell_renderer_combo_class_init): + Doc additions. + * gtk/gtkfilechooserbutton.h: Fix trigraphs in private markers. * gtk/gtkfilechooserbutton.c (gtk_file_chooser_button_class_init): diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index a8e95fd19b..cf4d3e9c4c 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,5 +1,11 @@ 2004-11-02 Matthias Clasen + * gtk/tmpl/gtkcellrenderercombo.sgml: + * gtk/tmpl/gtkcellrenderertoggle.sgml: + * gtk/tmpl/gtkcellrenderertext.sgml: Add introductions. + + * gtk/tmpl/gtkcellrenderer.sgml: Additions. + * gtk/gtk-sections.txt: Remove GtkFileChooserEmbed, since it is not in the headers we parse. diff --git a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml index 47d16ece1e..fc27be321b 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml @@ -19,8 +19,8 @@ elements on a #GdkDrawable. Typically, one cell renderer is used to draw many cells on the screen. To this extent, it isn't expected that a CellRenderer keep any permanent state around. Instead, any state is set just prior to use using #GObjects property system. Then, the -cell is measured using @gtk_cell_renderer_get_size. Finally, the cell -is rendered in the correct location using @gtk_cell_renderer_render. +cell is measured using gtk_cell_renderer_get_size(). Finally, the cell +is rendered in the correct location using gtk_cell_renderer_render(). @@ -31,6 +31,17 @@ barring a #GtkStyle change. The #GtkCellRenderer also has a number of generic properties that are expected to be honored by all children. + +Beyond merely rendering a cell, cell renderers can optionally +provide active user interface elements. A cell renderer can be +activatable like #GtkCellRendererToggle, +which toggles when it gets activated by a mouse click, or it can be +editable like #GtkCellRendererText, which +allows the user to edit the text using a #GtkEntry. +To make a cell renderer activatable or editable, you have to +implement the @activate or @start_editing virtual functions, +respectively. + #GtkCellRendererText,#GtkCellRendererPixbuf,#GtkCellRendererToggle diff --git a/docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml b/docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml index e0353c1119..fa9490e7e9 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderercombo.sgml @@ -2,11 +2,22 @@ GtkCellRendererCombo - +Renders a combobox in a cell +#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 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 +text-column property. Further +cell renderers can be added in a handler for the editing-started signal. diff --git a/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml b/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml index b574076f70..7ff0da00d1 100644 --- a/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrendererpixbuf.sgml @@ -7,20 +7,22 @@ Renders a pixbuf in a cell A #GtkCellRendererPixbuf can be used to render an image in a cell. It allows to render -either a given #GdkPixbuf (set via the pixbuf -property) or a stock icon (set via the stock-id -property). +either a given #GdkPixbuf (set via the +pixbuf property) or a stock icon +(set via the stock-id property). -To support the tree view, #GtkCellRendererPixbuf also supports rendering two alternative pixbufs, -when the is-expander property is %TRUE. -If the is-expander property is %TRUE and -the pixbuf-expander-open property -is set to a pixbuf, it renders that pixbuf, if the -is-expander property is %FALSE and -the pixbuf-expander-closed property -is set to a pixbuf, it renders that one. +To support the tree view, #GtkCellRendererPixbuf also supports rendering two alternative +pixbufs, when the is-expander property +is %TRUE. If the is-expanded property +is %TRUE and the +pixbuf-expander-open +property is set to a pixbuf, it renders that pixbuf, if the +is-expanded property is %FALSE and +the +pixbuf-expander-closed +property is set to a pixbuf, it renders that one. diff --git a/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml b/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml index 572408a34d..1dcd31fc04 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderertext.sgml @@ -6,7 +6,15 @@ Renders text in a cell +A #GtkCellRendererText renders a given text in its cell, using the font, color and +style information provided by its properties. The text will be ellipsized if it is +too long and the ellipsize +property allows it. + + +If the mode is %GTK_CELL_RENDERER_MODE_EDITABLE, +the #GtkCellRendererText allows to edit its text using an entry. diff --git a/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml b/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml index 12f75faf9d..34c49b336a 100644 --- a/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml +++ b/docs/reference/gtk/tmpl/gtkcellrenderertoggle.sgml @@ -6,7 +6,10 @@ Renders a toggle button in a cell - +#GtkCellRendererToggle renders a toggle button in a cell. The +button is drawn as a radio- or checkbutton, depending on the +radio +property. When activated, it emits the toggled signal. diff --git a/gtk/gtkcellrenderercombo.c b/gtk/gtkcellrenderercombo.c index f15bc7bad7..8b26a8d555 100644 --- a/gtk/gtkcellrenderercombo.c +++ b/gtk/gtkcellrenderercombo.c @@ -98,6 +98,9 @@ gtk_cell_renderer_combo_class_init (GtkCellRendererComboClass *klass) * not the model backing the tree view to which this cell * renderer is attached. * + * #GtkCellRendererCombo automatically adds a text cell renderer for this column + * to its combo box. + * * Since: 2.6 */ g_object_class_install_property (object_class, @@ -140,7 +143,7 @@ gtk_cell_renderer_combo_init (GtkCellRendererCombo *self) /** * gtk_cell_renderer_combo_new: * - * Creates a new #GtkCellRendererCombo + * Creates a new #GtkCellRendererCombo. * Adjust how text is drawn using object properties. * Object properties can be set globally (with g_object_set()). * Also, with #GtkTreeViewColumn, you can bind a property to a value