2 * Copyright (C) 2002, 2003 Kristian Rietveld <kris@gtk.org>
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Library General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Library General Public License for more details.
14 * You should have received a copy of the GNU Library General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
22 #include "gtkcellview.h"
23 #include "gtkcelllayout.h"
25 #include "gtksignal.h"
26 #include "gtkcellrenderertext.h"
27 #include "gtkcellrendererpixbuf.h"
28 #include <gobject/gmarshal.h>
30 typedef struct _GtkCellViewCellInfo GtkCellViewCellInfo;
31 struct _GtkCellViewCellInfo
33 GtkCellRenderer *cell;
42 GtkCellLayoutDataFunc func;
44 GDestroyNotify destroy;
47 struct _GtkCellViewPrivate
50 GtkTreeRowReference *displayed_row;
55 gboolean background_set;
59 static void gtk_cell_view_class_init (GtkCellViewClass *klass);
60 static void gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface);
61 static void gtk_cell_view_get_property (GObject *object,
65 static void gtk_cell_view_set_property (GObject *object,
69 static void gtk_cell_view_init (GtkCellView *cellview);
70 static void gtk_cell_view_finalize (GObject *object);
71 static void gtk_cell_view_style_set (GtkWidget *widget,
72 GtkStyle *previous_style);
73 static void gtk_cell_view_size_request (GtkWidget *widget,
74 GtkRequisition *requisition);
75 static void gtk_cell_view_size_allocate (GtkWidget *widget,
76 GtkAllocation *allocation);
77 static gboolean gtk_cell_view_expose (GtkWidget *widget,
78 GdkEventExpose *event);
79 static void gtk_cell_view_set_value (GtkCellView *cell_view,
80 GtkCellRenderer *renderer,
83 static GtkCellViewCellInfo *gtk_cell_view_get_cell_info (GtkCellView *cellview,
84 GtkCellRenderer *renderer);
85 static void gtk_cell_view_set_cell_data (GtkCellView *cell_view);
88 static void gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
89 GtkCellRenderer *renderer,
91 static void gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
92 GtkCellRenderer *renderer,
94 static void gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
95 GtkCellRenderer *renderer,
96 const gchar *attribute,
98 static void gtk_cell_view_cell_layout_clear (GtkCellLayout *layout);
99 static void gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
100 GtkCellRenderer *renderer);
101 static void gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
102 GtkCellRenderer *cell,
103 GtkCellLayoutDataFunc func,
105 GDestroyNotify destroy);
106 static void gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
107 GtkCellRenderer *cell,
111 #define GTK_CELL_VIEW_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_CELL_VIEW, GtkCellViewPrivate))
121 static GtkObjectClass *parent_class = NULL;
125 gtk_cell_view_get_type (void)
127 static GType cell_view_type = 0;
131 static const GTypeInfo cell_view_info =
133 sizeof (GtkCellViewClass),
134 NULL, /* base_init */
135 NULL, /* base_finalize */
136 (GClassInitFunc) gtk_cell_view_class_init,
137 NULL, /* class_finalize */
138 NULL, /* class_data */
139 sizeof (GtkCellView),
141 (GInstanceInitFunc) gtk_cell_view_init
144 static const GInterfaceInfo cell_layout_info =
146 (GInterfaceInitFunc) gtk_cell_view_cell_layout_init,
151 cell_view_type = g_type_register_static (GTK_TYPE_WIDGET, "GtkCellView",
154 g_type_add_interface_static (cell_view_type, GTK_TYPE_CELL_LAYOUT,
158 return cell_view_type;
162 gtk_cell_view_class_init (GtkCellViewClass *klass)
164 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
165 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
167 parent_class = g_type_class_peek_parent (klass);
169 gobject_class->get_property = gtk_cell_view_get_property;
170 gobject_class->set_property = gtk_cell_view_set_property;
171 gobject_class->finalize = gtk_cell_view_finalize;
173 widget_class->expose_event = gtk_cell_view_expose;
174 widget_class->size_allocate = gtk_cell_view_size_allocate;
175 widget_class->size_request = gtk_cell_view_size_request;
176 widget_class->style_set = gtk_cell_view_style_set;
179 g_object_class_install_property (gobject_class,
181 g_param_spec_string ("background",
182 P_("Background color name"),
183 P_("Background color as a string"),
186 g_object_class_install_property (gobject_class,
188 g_param_spec_boxed ("background_gdk",
189 P_("Background color"),
190 P_("Background color as a GdkColor"),
192 G_PARAM_READABLE | G_PARAM_WRITABLE));
194 #define ADD_SET_PROP(propname, propval, nick, blurb) g_object_class_install_property (gobject_class, propval, g_param_spec_boolean (propname, nick, blurb, FALSE, G_PARAM_READABLE | G_PARAM_WRITABLE))
196 ADD_SET_PROP ("background_set", PROP_BACKGROUND_SET,
197 P_("Background set"),
198 P_("Whether this tag affects the background color"));
200 g_type_class_add_private (gobject_class, sizeof (GtkCellViewPrivate));
204 gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface)
206 iface->pack_start = gtk_cell_view_cell_layout_pack_start;
207 iface->pack_end = gtk_cell_view_cell_layout_pack_end;
208 iface->clear = gtk_cell_view_cell_layout_clear;
209 iface->add_attribute = gtk_cell_view_cell_layout_add_attribute;
210 iface->set_cell_data_func = gtk_cell_view_cell_layout_set_cell_data_func;
211 iface->clear_attributes = gtk_cell_view_cell_layout_clear_attributes;
212 iface->reorder = gtk_cell_view_cell_layout_reorder;
216 gtk_cell_view_get_property (GObject *object,
221 GtkCellView *view = GTK_CELL_VIEW (object);
225 case PROP_BACKGROUND_GDK:
229 color = view->priv->background;
231 g_value_set_boxed (value, &color);
234 case PROP_BACKGROUND_SET:
235 g_value_set_boolean (value, view->priv->background_set);
238 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
244 gtk_cell_view_set_property (GObject *object,
249 GtkCellView *view = GTK_CELL_VIEW (object);
253 case PROP_BACKGROUND:
257 if (!g_value_get_string (value))
258 gtk_cell_view_set_background_color (view, NULL);
259 else if (gdk_color_parse (g_value_get_string (value), &color))
260 gtk_cell_view_set_background_color (view, &color);
262 g_warning ("Don't know color `%s'", g_value_get_string (value));
264 g_object_notify (object, "background_gdk");
267 case PROP_BACKGROUND_GDK:
268 gtk_cell_view_set_background_color (view, g_value_get_boxed (value));
270 case PROP_BACKGROUND_SET:
271 view->priv->background_set = g_value_get_boolean (value);
274 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
280 gtk_cell_view_init (GtkCellView *cellview)
282 GTK_WIDGET_SET_FLAGS (cellview, GTK_NO_WINDOW);
284 cellview->priv = GTK_CELL_VIEW_GET_PRIVATE (cellview);
288 gtk_cell_view_style_set (GtkWidget *widget,
289 GtkStyle *previous_style)
291 if (previous_style && GTK_WIDGET_REALIZED (widget))
292 gdk_window_set_background (widget->window,
293 &widget->style->base[GTK_WIDGET_STATE (widget)]);
297 gtk_cell_view_finalize (GObject *object)
299 GtkCellView *cellview = GTK_CELL_VIEW (object);
301 gtk_cell_view_cell_layout_clear (GTK_CELL_LAYOUT (cellview));
303 if (cellview->priv->model)
304 g_object_unref (cellview->priv->model);
306 if (cellview->priv->displayed_row)
307 gtk_tree_row_reference_free (cellview->priv->displayed_row);
309 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
313 gtk_cell_view_size_request (GtkWidget *widget,
314 GtkRequisition *requisition)
317 gboolean first_cell = TRUE;
318 GtkCellView *cellview;
320 cellview = GTK_CELL_VIEW (widget);
322 requisition->width = 0;
323 requisition->height = 0;
325 if (cellview->priv->displayed_row)
326 gtk_cell_view_set_cell_data (cellview);
328 for (i = cellview->priv->cell_list; i; i = i->next)
331 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
333 if (!info->cell->visible)
337 requisition->width += cellview->priv->spacing;
339 gtk_cell_renderer_get_size (info->cell, widget, NULL, NULL, NULL,
342 info->requested_width = width;
343 requisition->width += width;
344 requisition->height = MAX (requisition->height, height);
351 gtk_cell_view_size_allocate (GtkWidget *widget,
352 GtkAllocation *allocation)
355 gint expand_cell_count = 0;
356 gint full_requested_width = 0;
358 GtkCellView *cellview;
360 widget->allocation = *allocation;
362 cellview = GTK_CELL_VIEW (widget);
364 /* checking how much extra space we have */
365 for (i = cellview->priv->cell_list; i; i = i->next)
367 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
369 if (!info->cell->visible)
375 full_requested_width += info->requested_width;
378 extra_space = widget->allocation.width - full_requested_width;
381 else if (extra_space > 0 && expand_cell_count > 0)
382 extra_space /= expand_cell_count;
384 /* iterate list for PACK_START cells */
385 for (i = cellview->priv->cell_list; i; i = i->next)
387 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
389 if (info->pack == GTK_PACK_END)
392 if (!info->cell->visible)
395 info->real_width = info->requested_width + (info->expand?extra_space:0);
398 /* iterate list for PACK_END cells */
399 for (i = cellview->priv->cell_list; i; i = i->next)
401 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
403 if (info->pack == GTK_PACK_START)
406 if (!info->cell->visible)
409 info->real_width = info->requested_width + (info->expand?extra_space:0);
414 gtk_cell_view_expose (GtkWidget *widget,
415 GdkEventExpose *event)
418 GtkCellView *cellview;
420 GtkCellRendererState state;
421 gboolean rtl = (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL);
423 cellview = GTK_CELL_VIEW (widget);
425 if (! GTK_WIDGET_DRAWABLE (widget))
428 /* "blank" background */
429 if (cellview->priv->background_set)
433 gc = gdk_gc_new (GTK_WIDGET (cellview)->window);
434 gdk_gc_set_rgb_fg_color (gc, &cellview->priv->background);
436 gdk_draw_rectangle (GTK_WIDGET (cellview)->window,
441 widget->allocation.x,
442 widget->allocation.y,
444 widget->allocation.width,
445 widget->allocation.height);
450 /* set cell data (if available) */
451 if (cellview->priv->displayed_row)
452 gtk_cell_view_set_cell_data (cellview);
453 else if (cellview->priv->model)
457 area = widget->allocation;
459 /* we draw on our very own window, initialize x and y to zero */
460 area.x = widget->allocation.x + (rtl ? widget->allocation.width : 0);
461 area.y = widget->allocation.y;
463 if (GTK_WIDGET_STATE (widget) == GTK_STATE_PRELIGHT)
464 state = GTK_CELL_RENDERER_PRELIT;
469 for (i = cellview->priv->cell_list; i; i = i->next)
471 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
473 if (info->pack == GTK_PACK_END)
476 if (!info->cell->visible)
479 area.width = info->real_width;
481 area.x -= area.width;
483 gtk_cell_renderer_render (info->cell,
487 &area, &area, &event->area, state);
490 area.x += info->real_width;
493 area.x = rtl ? widget->allocation.x : (widget->allocation.x + widget->allocation.width);
496 for (i = cellview->priv->cell_list; i; i = i->next)
498 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
500 if (info->pack == GTK_PACK_START)
503 if (!info->cell->visible)
506 area.width = info->real_width;
508 area.x -= area.width;
510 gtk_cell_renderer_render (info->cell,
514 &area, &area, &event->area, state);
516 area.x += info->real_width;
522 static GtkCellViewCellInfo *
523 gtk_cell_view_get_cell_info (GtkCellView *cellview,
524 GtkCellRenderer *renderer)
528 for (i = cellview->priv->cell_list; i; i = i->next)
530 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
532 if (info->cell == renderer)
540 gtk_cell_view_set_cell_data (GtkCellView *cell_view)
546 g_return_if_fail (cell_view->priv->displayed_row != NULL);
548 path = gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
552 gtk_tree_model_get_iter (cell_view->priv->model, &iter, path);
553 gtk_tree_path_free (path);
555 for (i = cell_view->priv->cell_list; i; i = i->next)
558 GtkCellViewCellInfo *info = i->data;
560 g_object_freeze_notify (G_OBJECT (info->cell));
562 for (j = info->attributes; j && j->next; j = j->next->next)
564 gchar *property = j->data;
565 gint column = GPOINTER_TO_INT (j->next->data);
566 GValue value = {0, };
568 gtk_tree_model_get_value (cell_view->priv->model, &iter,
570 g_object_set_property (G_OBJECT (info->cell),
572 g_value_unset (&value);
576 (* info->func) (GTK_CELL_LAYOUT (cell_view),
578 cell_view->priv->model,
582 g_object_thaw_notify (G_OBJECT (info->cell));
586 /* GtkCellLayout implementation */
588 gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
589 GtkCellRenderer *renderer,
592 GtkCellViewCellInfo *info;
593 GtkCellView *cellview = GTK_CELL_VIEW (layout);
595 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
596 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
597 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
599 g_object_ref (renderer);
600 gtk_object_sink (GTK_OBJECT (renderer));
602 info = g_new0 (GtkCellViewCellInfo, 1);
603 info->cell = renderer;
604 info->expand = expand ? TRUE : FALSE;
605 info->pack = GTK_PACK_START;
607 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
611 gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
612 GtkCellRenderer *renderer,
615 GtkCellViewCellInfo *info;
616 GtkCellView *cellview = GTK_CELL_VIEW (layout);
618 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
619 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
620 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
622 g_object_ref (renderer);
623 gtk_object_sink (GTK_OBJECT (renderer));
625 info = g_new0 (GtkCellViewCellInfo, 1);
626 info->cell = renderer;
627 info->expand = expand ? TRUE : FALSE;
628 info->pack = GTK_PACK_END;
630 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
634 gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
635 GtkCellRenderer *renderer,
636 const gchar *attribute,
639 GtkCellViewCellInfo *info;
640 GtkCellView *cellview = GTK_CELL_VIEW (layout);
642 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
643 info = gtk_cell_view_get_cell_info (cellview, renderer);
644 g_return_if_fail (info != NULL);
646 info->attributes = g_slist_prepend (info->attributes,
647 GINT_TO_POINTER (column));
648 info->attributes = g_slist_prepend (info->attributes,
649 g_strdup (attribute));
653 gtk_cell_view_cell_layout_clear (GtkCellLayout *layout)
655 GtkCellView *cellview = GTK_CELL_VIEW (layout);
657 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
659 while (cellview->priv->cell_list)
661 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)cellview->priv->cell_list->data;
663 gtk_cell_view_cell_layout_clear_attributes (layout, info->cell);
664 g_object_unref (info->cell);
666 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
667 cellview->priv->cell_list);
672 gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
673 GtkCellRenderer *cell,
674 GtkCellLayoutDataFunc func,
676 GDestroyNotify destroy)
678 GtkCellView *cellview = GTK_CELL_VIEW (layout);
679 GtkCellViewCellInfo *info;
681 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
683 info = gtk_cell_view_get_cell_info (cellview, cell);
684 g_return_if_fail (info != NULL);
688 GDestroyNotify d = info->destroy;
690 info->destroy = NULL;
695 info->func_data = func_data;
696 info->destroy = destroy;
700 gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
701 GtkCellRenderer *renderer)
703 GtkCellViewCellInfo *info;
704 GtkCellView *cellview = GTK_CELL_VIEW (layout);
707 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
708 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
710 info = gtk_cell_view_get_cell_info (cellview, renderer);
713 list = info->attributes;
714 while (list && list->next)
717 list = list->next->next;
720 g_slist_free (info->attributes);
721 info->attributes = NULL;
726 gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
727 GtkCellRenderer *cell,
731 GtkCellViewCellInfo *info;
732 GtkCellView *cellview = GTK_CELL_VIEW (layout);
734 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
735 g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
737 info = gtk_cell_view_get_cell_info (cellview, cell);
739 g_return_if_fail (info != NULL);
740 g_return_if_fail (position >= 0);
742 link = g_list_find (cellview->priv->cell_list, info);
744 g_return_if_fail (link != NULL);
746 cellview->priv->cell_list = g_list_remove_link (cellview->priv->cell_list,
748 cellview->priv->cell_list = g_list_insert (cellview->priv->cell_list,
751 gtk_widget_queue_draw (GTK_WIDGET (cellview));
757 * Creates a new #GtkCellView widget.
759 * Return value: A newly created #GtkCellView widget.
764 gtk_cell_view_new (void)
766 GtkCellView *cellview;
768 cellview = g_object_new (gtk_cell_view_get_type (), NULL);
770 return GTK_WIDGET (cellview);
774 * gtk_cell_view_new_with_text:
775 * @text: the text to display in the cell view
777 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
778 * to it, and makes its show @text.
780 * Return value: A newly created #GtkCellView widget.
785 gtk_cell_view_new_with_text (const gchar *text)
787 GtkCellView *cellview;
788 GtkCellRenderer *renderer;
789 GValue value = {0, };
791 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
793 renderer = gtk_cell_renderer_text_new ();
794 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
797 g_value_init (&value, G_TYPE_STRING);
798 g_value_set_string (&value, text);
799 gtk_cell_view_set_value (cellview, renderer, "text", &value);
800 g_value_unset (&value);
802 return GTK_WIDGET (cellview);
806 * gtk_cell_view_new_with_markup:
807 * @markup: the text to display in the cell view
809 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
810 * to it, and makes its show @markup. The text can text can be
811 * marked up with the <link linkend="PangoMarkupFormat">Pango text
812 * markup language</link>.
814 * Return value: A newly created #GtkCellView widget.
819 gtk_cell_view_new_with_markup (const gchar *markup)
821 GtkCellView *cellview;
822 GtkCellRenderer *renderer;
823 GValue value = {0, };
825 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
827 renderer = gtk_cell_renderer_text_new ();
828 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
831 g_value_init (&value, G_TYPE_STRING);
832 g_value_set_string (&value, markup);
833 gtk_cell_view_set_value (cellview, renderer, "markup", &value);
834 g_value_unset (&value);
836 return GTK_WIDGET (cellview);
840 * gtk_cell_view_new_with_pixbuf:
841 * @pixbuf: the image to display in the cell view
843 * Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf
844 * to it, and makes its show @pixbuf.
846 * Return value: A newly created #GtkCellView widget.
851 gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf)
853 GtkCellView *cellview;
854 GtkCellRenderer *renderer;
855 GValue value = {0, };
857 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
859 renderer = gtk_cell_renderer_pixbuf_new ();
860 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
863 g_value_init (&value, GDK_TYPE_PIXBUF);
864 g_value_set_object (&value, pixbuf);
865 gtk_cell_view_set_value (cellview, renderer, "pixbuf", &value);
866 g_value_unset (&value);
868 return GTK_WIDGET (cellview);
872 * gtk_cell_view_set_value:
873 * @cell_view: a #GtkCellView widget
874 * @renderer: one of the renderers of @cell_view
875 * @property: the name of the property of @renderer to set
876 * @value: the new value to set the property to
878 * Sets a property of a cell renderer of @cell_view, and
879 * makes sure the display of @cell_view is updated.
884 gtk_cell_view_set_value (GtkCellView *cell_view,
885 GtkCellRenderer *renderer,
889 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
890 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
892 g_object_set_property (G_OBJECT (renderer), property, value);
894 /* force resize and redraw */
895 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
896 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
900 * gtk_cell_view_set_model:
901 * @cell_view: a #GtkCellView
902 * @model: a #GtkTreeModel
904 * Sets the model for @cell_view. If @cell_view already has a model
905 * set, it will remove it before setting the new model. If @model is
906 * %NULL, then it will unset the old model.
911 gtk_cell_view_set_model (GtkCellView *cell_view,
914 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
915 g_return_if_fail (GTK_IS_TREE_MODEL (model));
917 if (cell_view->priv->model)
919 if (cell_view->priv->displayed_row)
920 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
921 cell_view->priv->displayed_row = NULL;
923 g_object_unref (cell_view->priv->model);
924 cell_view->priv->model = NULL;
927 cell_view->priv->model = model;
929 if (cell_view->priv->model)
930 g_object_ref (cell_view->priv->model);
934 * gtk_cell_view_set_displayed_row:
935 * @cell_view: a #GtkCellView
936 * @path: a #GtkTreePath or %NULL to unset.
938 * Sets the row of the model that is currently displayed
939 * by the #GtkCellView. If the path is unset, then the
940 * contents of the cellview "stick" at their last value;
941 * this is not normally a desired result, but may be
942 * a needed intermediate state if say, the model for
943 * the #GtkCellView becomes temporarily empty.
948 gtk_cell_view_set_displayed_row (GtkCellView *cell_view,
951 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
952 g_return_if_fail (GTK_IS_TREE_MODEL (cell_view->priv->model));
954 if (cell_view->priv->displayed_row)
955 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
959 cell_view->priv->displayed_row =
960 gtk_tree_row_reference_new (cell_view->priv->model, path);
963 cell_view->priv->displayed_row = NULL;
965 /* force resize and redraw */
966 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
967 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
971 gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
973 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
975 if (!cell_view->priv->displayed_row)
978 return gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
982 * gtk_cell_view_get_size_of_row:
983 * @cell_view: a #GtkCellView
984 * @path: a #GtkTreePath
985 * @requisition: return location for the size
987 * Sets @requisition to the size needed by @cell_view to display
988 * the model row pointed to by @path.
990 * Return value: %TRUE
995 gtk_cell_view_get_size_of_row (GtkCellView *cell_view,
997 GtkRequisition *requisition)
999 GtkTreeRowReference *tmp;
1002 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), FALSE);
1003 g_return_val_if_fail (path != NULL, FALSE);
1004 g_return_val_if_fail (requisition != NULL, FALSE);
1006 tmp = cell_view->priv->displayed_row;
1007 cell_view->priv->displayed_row =
1008 gtk_tree_row_reference_new (cell_view->priv->model, path);
1010 gtk_cell_view_size_request (GTK_WIDGET (cell_view), requisition);
1012 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1013 cell_view->priv->displayed_row = tmp;
1015 /* restore actual size info */
1016 gtk_cell_view_size_request (GTK_WIDGET (cell_view), &req);
1022 * gtk_cell_view_set_background_color:
1023 * @cell_view: a #GtkCellView
1024 * @color: the new background color
1026 * Sets the background color of @view.
1031 gtk_cell_view_set_background_color (GtkCellView *cell_view,
1032 const GdkColor *color)
1034 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1038 if (!cell_view->priv->background_set)
1040 cell_view->priv->background_set = TRUE;
1041 g_object_notify (G_OBJECT (cell_view), "background_set");
1044 cell_view->priv->background = *color;
1048 if (cell_view->priv->background_set)
1050 cell_view->priv->background_set = FALSE;
1051 g_object_notify (G_OBJECT (cell_view), "background_set");
1055 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1059 * gtk_cell_view_get_cell_renderers:
1060 * @cell_view: a #GtkCellView
1062 * Returns the cell renderers which have been added to @cell_view.
1064 * Return value: a list of cell renderers. The list, but not the
1065 * renderers has been newly allocated and should be freed with
1066 * g_list_free() when no longer needed.
1071 gtk_cell_view_get_cell_renderers (GtkCellView *cell_view)
1073 GList *retval = NULL, *list;
1075 g_return_val_if_fail (cell_view != NULL, NULL);
1077 gtk_cell_view_set_cell_data (cell_view);
1079 for (list = cell_view->priv->cell_list; list; list = list->next)
1081 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1083 retval = g_list_prepend (retval, info->cell);
1086 return g_list_reverse (retval);