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.
21 #include "gtkcellview.h"
22 #include "gtkcelllayout.h"
24 #include "gtksignal.h"
25 #include "gtkcellrenderertext.h"
26 #include "gtkcellrendererpixbuf.h"
27 #include "gtkprivate.h"
28 #include <gobject/gmarshal.h>
31 typedef struct _GtkCellViewCellInfo GtkCellViewCellInfo;
32 struct _GtkCellViewCellInfo
34 GtkCellRenderer *cell;
43 GtkCellLayoutDataFunc func;
45 GDestroyNotify destroy;
48 struct _GtkCellViewPrivate
51 GtkTreeRowReference *displayed_row;
56 gboolean background_set;
60 static void gtk_cell_view_class_init (GtkCellViewClass *klass);
61 static void gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface);
62 static void gtk_cell_view_get_property (GObject *object,
66 static void gtk_cell_view_set_property (GObject *object,
70 static void gtk_cell_view_init (GtkCellView *cellview);
71 static void gtk_cell_view_finalize (GObject *object);
72 static void gtk_cell_view_style_set (GtkWidget *widget,
73 GtkStyle *previous_style);
74 static void gtk_cell_view_size_request (GtkWidget *widget,
75 GtkRequisition *requisition);
76 static void gtk_cell_view_size_allocate (GtkWidget *widget,
77 GtkAllocation *allocation);
78 static gboolean gtk_cell_view_expose (GtkWidget *widget,
79 GdkEventExpose *event);
80 static void gtk_cell_view_set_value (GtkCellView *cell_view,
81 GtkCellRenderer *renderer,
84 static GtkCellViewCellInfo *gtk_cell_view_get_cell_info (GtkCellView *cellview,
85 GtkCellRenderer *renderer);
86 static void gtk_cell_view_set_cell_data (GtkCellView *cell_view);
89 static void gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
90 GtkCellRenderer *renderer,
92 static void gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
93 GtkCellRenderer *renderer,
95 static void gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
96 GtkCellRenderer *renderer,
97 const gchar *attribute,
99 static void gtk_cell_view_cell_layout_clear (GtkCellLayout *layout);
100 static void gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
101 GtkCellRenderer *renderer);
102 static void gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
103 GtkCellRenderer *cell,
104 GtkCellLayoutDataFunc func,
106 GDestroyNotify destroy);
107 static void gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
108 GtkCellRenderer *cell,
112 #define GTK_CELL_VIEW_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_CELL_VIEW, GtkCellViewPrivate))
122 static GtkObjectClass *parent_class = NULL;
126 gtk_cell_view_get_type (void)
128 static GType cell_view_type = 0;
132 static const GTypeInfo cell_view_info =
134 sizeof (GtkCellViewClass),
135 NULL, /* base_init */
136 NULL, /* base_finalize */
137 (GClassInitFunc) gtk_cell_view_class_init,
138 NULL, /* class_finalize */
139 NULL, /* class_data */
140 sizeof (GtkCellView),
142 (GInstanceInitFunc) gtk_cell_view_init
145 static const GInterfaceInfo cell_layout_info =
147 (GInterfaceInitFunc) gtk_cell_view_cell_layout_init,
152 cell_view_type = g_type_register_static (GTK_TYPE_WIDGET, "GtkCellView",
155 g_type_add_interface_static (cell_view_type, GTK_TYPE_CELL_LAYOUT,
159 return cell_view_type;
163 gtk_cell_view_class_init (GtkCellViewClass *klass)
165 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
166 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
168 parent_class = g_type_class_peek_parent (klass);
170 gobject_class->get_property = gtk_cell_view_get_property;
171 gobject_class->set_property = gtk_cell_view_set_property;
172 gobject_class->finalize = gtk_cell_view_finalize;
174 widget_class->expose_event = gtk_cell_view_expose;
175 widget_class->size_allocate = gtk_cell_view_size_allocate;
176 widget_class->size_request = gtk_cell_view_size_request;
177 widget_class->style_set = gtk_cell_view_style_set;
180 g_object_class_install_property (gobject_class,
182 g_param_spec_string ("background",
183 P_("Background color name"),
184 P_("Background color as a string"),
186 GTK_PARAM_WRITABLE));
187 g_object_class_install_property (gobject_class,
189 g_param_spec_boxed ("background-gdk",
190 P_("Background color"),
191 P_("Background color as a GdkColor"),
193 GTK_PARAM_READWRITE));
195 #define ADD_SET_PROP(propname, propval, nick, blurb) g_object_class_install_property (gobject_class, propval, g_param_spec_boolean (propname, nick, blurb, FALSE, GTK_PARAM_READWRITE))
197 ADD_SET_PROP ("background-set", PROP_BACKGROUND_SET,
198 P_("Background set"),
199 P_("Whether this tag affects the background color"));
201 g_type_class_add_private (gobject_class, sizeof (GtkCellViewPrivate));
205 gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface)
207 iface->pack_start = gtk_cell_view_cell_layout_pack_start;
208 iface->pack_end = gtk_cell_view_cell_layout_pack_end;
209 iface->clear = gtk_cell_view_cell_layout_clear;
210 iface->add_attribute = gtk_cell_view_cell_layout_add_attribute;
211 iface->set_cell_data_func = gtk_cell_view_cell_layout_set_cell_data_func;
212 iface->clear_attributes = gtk_cell_view_cell_layout_clear_attributes;
213 iface->reorder = gtk_cell_view_cell_layout_reorder;
217 gtk_cell_view_get_property (GObject *object,
222 GtkCellView *view = GTK_CELL_VIEW (object);
226 case PROP_BACKGROUND_GDK:
230 color = view->priv->background;
232 g_value_set_boxed (value, &color);
235 case PROP_BACKGROUND_SET:
236 g_value_set_boolean (value, view->priv->background_set);
239 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
245 gtk_cell_view_set_property (GObject *object,
250 GtkCellView *view = GTK_CELL_VIEW (object);
254 case PROP_BACKGROUND:
258 if (!g_value_get_string (value))
259 gtk_cell_view_set_background_color (view, NULL);
260 else if (gdk_color_parse (g_value_get_string (value), &color))
261 gtk_cell_view_set_background_color (view, &color);
263 g_warning ("Don't know color `%s'", g_value_get_string (value));
265 g_object_notify (object, "background_gdk");
268 case PROP_BACKGROUND_GDK:
269 gtk_cell_view_set_background_color (view, g_value_get_boxed (value));
271 case PROP_BACKGROUND_SET:
272 view->priv->background_set = g_value_get_boolean (value);
275 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
281 gtk_cell_view_init (GtkCellView *cellview)
283 GTK_WIDGET_SET_FLAGS (cellview, GTK_NO_WINDOW);
285 cellview->priv = GTK_CELL_VIEW_GET_PRIVATE (cellview);
289 gtk_cell_view_style_set (GtkWidget *widget,
290 GtkStyle *previous_style)
292 if (previous_style && GTK_WIDGET_REALIZED (widget))
293 gdk_window_set_background (widget->window,
294 &widget->style->base[GTK_WIDGET_STATE (widget)]);
298 gtk_cell_view_finalize (GObject *object)
300 GtkCellView *cellview = GTK_CELL_VIEW (object);
302 gtk_cell_view_cell_layout_clear (GTK_CELL_LAYOUT (cellview));
304 if (cellview->priv->model)
305 g_object_unref (cellview->priv->model);
307 if (cellview->priv->displayed_row)
308 gtk_tree_row_reference_free (cellview->priv->displayed_row);
310 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
314 gtk_cell_view_size_request (GtkWidget *widget,
315 GtkRequisition *requisition)
318 gboolean first_cell = TRUE;
319 GtkCellView *cellview;
321 cellview = GTK_CELL_VIEW (widget);
323 requisition->width = 0;
324 requisition->height = 0;
326 if (cellview->priv->displayed_row)
327 gtk_cell_view_set_cell_data (cellview);
329 for (i = cellview->priv->cell_list; i; i = i->next)
332 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
334 if (!info->cell->visible)
338 requisition->width += cellview->priv->spacing;
340 gtk_cell_renderer_get_size (info->cell, widget, NULL, NULL, NULL,
343 info->requested_width = width;
344 requisition->width += width;
345 requisition->height = MAX (requisition->height, height);
352 gtk_cell_view_size_allocate (GtkWidget *widget,
353 GtkAllocation *allocation)
356 gint expand_cell_count = 0;
357 gint full_requested_width = 0;
359 GtkCellView *cellview;
361 widget->allocation = *allocation;
363 cellview = GTK_CELL_VIEW (widget);
365 /* checking how much extra space we have */
366 for (i = cellview->priv->cell_list; i; i = i->next)
368 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
370 if (!info->cell->visible)
376 full_requested_width += info->requested_width;
379 extra_space = widget->allocation.width - full_requested_width;
382 else if (extra_space > 0 && expand_cell_count > 0)
383 extra_space /= expand_cell_count;
385 /* iterate list for PACK_START cells */
386 for (i = cellview->priv->cell_list; i; i = i->next)
388 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
390 if (info->pack == GTK_PACK_END)
393 if (!info->cell->visible)
396 info->real_width = info->requested_width + (info->expand?extra_space:0);
399 /* iterate list for PACK_END cells */
400 for (i = cellview->priv->cell_list; i; i = i->next)
402 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
404 if (info->pack == GTK_PACK_START)
407 if (!info->cell->visible)
410 info->real_width = info->requested_width + (info->expand?extra_space:0);
415 gtk_cell_view_expose (GtkWidget *widget,
416 GdkEventExpose *event)
419 GtkCellView *cellview;
421 GtkCellRendererState state;
422 gboolean rtl = (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL);
424 cellview = GTK_CELL_VIEW (widget);
426 if (! GTK_WIDGET_DRAWABLE (widget))
429 /* "blank" background */
430 if (cellview->priv->background_set)
434 gc = gdk_gc_new (GTK_WIDGET (cellview)->window);
435 gdk_gc_set_rgb_fg_color (gc, &cellview->priv->background);
437 gdk_draw_rectangle (GTK_WIDGET (cellview)->window,
442 widget->allocation.x,
443 widget->allocation.y,
445 widget->allocation.width,
446 widget->allocation.height);
451 /* set cell data (if available) */
452 if (cellview->priv->displayed_row)
453 gtk_cell_view_set_cell_data (cellview);
454 else if (cellview->priv->model)
458 area = widget->allocation;
460 /* we draw on our very own window, initialize x and y to zero */
461 area.x = widget->allocation.x + (rtl ? widget->allocation.width : 0);
462 area.y = widget->allocation.y;
464 if (GTK_WIDGET_STATE (widget) == GTK_STATE_PRELIGHT)
465 state = GTK_CELL_RENDERER_PRELIT;
470 for (i = cellview->priv->cell_list; i; i = i->next)
472 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
474 if (info->pack == GTK_PACK_END)
477 if (!info->cell->visible)
480 area.width = info->real_width;
482 area.x -= area.width;
484 gtk_cell_renderer_render (info->cell,
488 &area, &area, &event->area, state);
491 area.x += info->real_width;
494 area.x = rtl ? widget->allocation.x : (widget->allocation.x + widget->allocation.width);
497 for (i = cellview->priv->cell_list; i; i = i->next)
499 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
501 if (info->pack == GTK_PACK_START)
504 if (!info->cell->visible)
507 area.width = info->real_width;
509 area.x -= area.width;
511 gtk_cell_renderer_render (info->cell,
515 &area, &area, &event->area, state);
517 area.x += info->real_width;
523 static GtkCellViewCellInfo *
524 gtk_cell_view_get_cell_info (GtkCellView *cellview,
525 GtkCellRenderer *renderer)
529 for (i = cellview->priv->cell_list; i; i = i->next)
531 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
533 if (info->cell == renderer)
541 gtk_cell_view_set_cell_data (GtkCellView *cell_view)
547 g_return_if_fail (cell_view->priv->displayed_row != NULL);
549 path = gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
553 gtk_tree_model_get_iter (cell_view->priv->model, &iter, path);
554 gtk_tree_path_free (path);
556 for (i = cell_view->priv->cell_list; i; i = i->next)
559 GtkCellViewCellInfo *info = i->data;
561 g_object_freeze_notify (G_OBJECT (info->cell));
563 for (j = info->attributes; j && j->next; j = j->next->next)
565 gchar *property = j->data;
566 gint column = GPOINTER_TO_INT (j->next->data);
567 GValue value = {0, };
569 gtk_tree_model_get_value (cell_view->priv->model, &iter,
571 g_object_set_property (G_OBJECT (info->cell),
573 g_value_unset (&value);
577 (* info->func) (GTK_CELL_LAYOUT (cell_view),
579 cell_view->priv->model,
583 g_object_thaw_notify (G_OBJECT (info->cell));
587 /* GtkCellLayout implementation */
589 gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
590 GtkCellRenderer *renderer,
593 GtkCellViewCellInfo *info;
594 GtkCellView *cellview = GTK_CELL_VIEW (layout);
596 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
597 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
598 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
600 g_object_ref (renderer);
601 gtk_object_sink (GTK_OBJECT (renderer));
603 info = g_new0 (GtkCellViewCellInfo, 1);
604 info->cell = renderer;
605 info->expand = expand ? TRUE : FALSE;
606 info->pack = GTK_PACK_START;
608 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
612 gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
613 GtkCellRenderer *renderer,
616 GtkCellViewCellInfo *info;
617 GtkCellView *cellview = GTK_CELL_VIEW (layout);
619 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
620 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
621 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
623 g_object_ref (renderer);
624 gtk_object_sink (GTK_OBJECT (renderer));
626 info = g_new0 (GtkCellViewCellInfo, 1);
627 info->cell = renderer;
628 info->expand = expand ? TRUE : FALSE;
629 info->pack = GTK_PACK_END;
631 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
635 gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
636 GtkCellRenderer *renderer,
637 const gchar *attribute,
640 GtkCellViewCellInfo *info;
641 GtkCellView *cellview = GTK_CELL_VIEW (layout);
643 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
644 info = gtk_cell_view_get_cell_info (cellview, renderer);
645 g_return_if_fail (info != NULL);
647 info->attributes = g_slist_prepend (info->attributes,
648 GINT_TO_POINTER (column));
649 info->attributes = g_slist_prepend (info->attributes,
650 g_strdup (attribute));
654 gtk_cell_view_cell_layout_clear (GtkCellLayout *layout)
656 GtkCellView *cellview = GTK_CELL_VIEW (layout);
658 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
660 while (cellview->priv->cell_list)
662 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)cellview->priv->cell_list->data;
664 gtk_cell_view_cell_layout_clear_attributes (layout, info->cell);
665 g_object_unref (info->cell);
667 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
668 cellview->priv->cell_list);
673 gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
674 GtkCellRenderer *cell,
675 GtkCellLayoutDataFunc func,
677 GDestroyNotify destroy)
679 GtkCellView *cellview = GTK_CELL_VIEW (layout);
680 GtkCellViewCellInfo *info;
682 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
684 info = gtk_cell_view_get_cell_info (cellview, cell);
685 g_return_if_fail (info != NULL);
689 GDestroyNotify d = info->destroy;
691 info->destroy = NULL;
696 info->func_data = func_data;
697 info->destroy = destroy;
701 gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
702 GtkCellRenderer *renderer)
704 GtkCellViewCellInfo *info;
705 GtkCellView *cellview = GTK_CELL_VIEW (layout);
708 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
709 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
711 info = gtk_cell_view_get_cell_info (cellview, renderer);
714 list = info->attributes;
715 while (list && list->next)
718 list = list->next->next;
721 g_slist_free (info->attributes);
722 info->attributes = NULL;
727 gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
728 GtkCellRenderer *cell,
732 GtkCellViewCellInfo *info;
733 GtkCellView *cellview = GTK_CELL_VIEW (layout);
735 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
736 g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
738 info = gtk_cell_view_get_cell_info (cellview, cell);
740 g_return_if_fail (info != NULL);
741 g_return_if_fail (position >= 0);
743 link = g_list_find (cellview->priv->cell_list, info);
745 g_return_if_fail (link != NULL);
747 cellview->priv->cell_list = g_list_remove_link (cellview->priv->cell_list,
749 cellview->priv->cell_list = g_list_insert (cellview->priv->cell_list,
752 gtk_widget_queue_draw (GTK_WIDGET (cellview));
758 * Creates a new #GtkCellView widget.
760 * Return value: A newly created #GtkCellView widget.
765 gtk_cell_view_new (void)
767 GtkCellView *cellview;
769 cellview = g_object_new (gtk_cell_view_get_type (), NULL);
771 return GTK_WIDGET (cellview);
775 * gtk_cell_view_new_with_text:
776 * @text: the text to display in the cell view
778 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
779 * to it, and makes its show @text.
781 * Return value: A newly created #GtkCellView widget.
786 gtk_cell_view_new_with_text (const gchar *text)
788 GtkCellView *cellview;
789 GtkCellRenderer *renderer;
790 GValue value = {0, };
792 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
794 renderer = gtk_cell_renderer_text_new ();
795 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
798 g_value_init (&value, G_TYPE_STRING);
799 g_value_set_string (&value, text);
800 gtk_cell_view_set_value (cellview, renderer, "text", &value);
801 g_value_unset (&value);
803 return GTK_WIDGET (cellview);
807 * gtk_cell_view_new_with_markup:
808 * @markup: the text to display in the cell view
810 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
811 * to it, and makes its show @markup. The text can text can be
812 * marked up with the <link linkend="PangoMarkupFormat">Pango text
813 * markup language</link>.
815 * Return value: A newly created #GtkCellView widget.
820 gtk_cell_view_new_with_markup (const gchar *markup)
822 GtkCellView *cellview;
823 GtkCellRenderer *renderer;
824 GValue value = {0, };
826 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
828 renderer = gtk_cell_renderer_text_new ();
829 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
832 g_value_init (&value, G_TYPE_STRING);
833 g_value_set_string (&value, markup);
834 gtk_cell_view_set_value (cellview, renderer, "markup", &value);
835 g_value_unset (&value);
837 return GTK_WIDGET (cellview);
841 * gtk_cell_view_new_with_pixbuf:
842 * @pixbuf: the image to display in the cell view
844 * Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf
845 * to it, and makes its show @pixbuf.
847 * Return value: A newly created #GtkCellView widget.
852 gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf)
854 GtkCellView *cellview;
855 GtkCellRenderer *renderer;
856 GValue value = {0, };
858 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
860 renderer = gtk_cell_renderer_pixbuf_new ();
861 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
864 g_value_init (&value, GDK_TYPE_PIXBUF);
865 g_value_set_object (&value, pixbuf);
866 gtk_cell_view_set_value (cellview, renderer, "pixbuf", &value);
867 g_value_unset (&value);
869 return GTK_WIDGET (cellview);
873 * gtk_cell_view_set_value:
874 * @cell_view: a #GtkCellView widget
875 * @renderer: one of the renderers of @cell_view
876 * @property: the name of the property of @renderer to set
877 * @value: the new value to set the property to
879 * Sets a property of a cell renderer of @cell_view, and
880 * makes sure the display of @cell_view is updated.
885 gtk_cell_view_set_value (GtkCellView *cell_view,
886 GtkCellRenderer *renderer,
890 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
891 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
893 g_object_set_property (G_OBJECT (renderer), property, value);
895 /* force resize and redraw */
896 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
897 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
901 * gtk_cell_view_set_model:
902 * @cell_view: a #GtkCellView
903 * @model: a #GtkTreeModel
905 * Sets the model for @cell_view. If @cell_view already has a model
906 * set, it will remove it before setting the new model. If @model is
907 * %NULL, then it will unset the old model.
912 gtk_cell_view_set_model (GtkCellView *cell_view,
915 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
916 g_return_if_fail (GTK_IS_TREE_MODEL (model));
918 if (cell_view->priv->model)
920 if (cell_view->priv->displayed_row)
921 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
922 cell_view->priv->displayed_row = NULL;
924 g_object_unref (cell_view->priv->model);
925 cell_view->priv->model = NULL;
928 cell_view->priv->model = model;
930 if (cell_view->priv->model)
931 g_object_ref (cell_view->priv->model);
935 * gtk_cell_view_set_displayed_row:
936 * @cell_view: a #GtkCellView
937 * @path: a #GtkTreePath or %NULL to unset.
939 * Sets the row of the model that is currently displayed
940 * by the #GtkCellView. If the path is unset, then the
941 * contents of the cellview "stick" at their last value;
942 * this is not normally a desired result, but may be
943 * a needed intermediate state if say, the model for
944 * the #GtkCellView becomes temporarily empty.
949 gtk_cell_view_set_displayed_row (GtkCellView *cell_view,
952 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
953 g_return_if_fail (GTK_IS_TREE_MODEL (cell_view->priv->model));
955 if (cell_view->priv->displayed_row)
956 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
960 cell_view->priv->displayed_row =
961 gtk_tree_row_reference_new (cell_view->priv->model, path);
964 cell_view->priv->displayed_row = NULL;
966 /* force resize and redraw */
967 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
968 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
972 * gtk_cell_view_get_displayed_row:
973 * @cell_view: a #GtkCellView
975 * Returns a #GtkTreePath referring to the currently
976 * displayed row. If no row is currently displayed,
979 * Returns: the currently displayed row or %NULL
984 gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
986 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
988 if (!cell_view->priv->displayed_row)
991 return gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
995 * gtk_cell_view_get_size_of_row:
996 * @cell_view: a #GtkCellView
997 * @path: a #GtkTreePath
998 * @requisition: return location for the size
1000 * Sets @requisition to the size needed by @cell_view to display
1001 * the model row pointed to by @path.
1003 * Return value: %TRUE
1008 gtk_cell_view_get_size_of_row (GtkCellView *cell_view,
1010 GtkRequisition *requisition)
1012 GtkTreeRowReference *tmp;
1015 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), FALSE);
1016 g_return_val_if_fail (path != NULL, FALSE);
1017 g_return_val_if_fail (requisition != NULL, FALSE);
1019 tmp = cell_view->priv->displayed_row;
1020 cell_view->priv->displayed_row =
1021 gtk_tree_row_reference_new (cell_view->priv->model, path);
1023 gtk_cell_view_size_request (GTK_WIDGET (cell_view), requisition);
1025 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1026 cell_view->priv->displayed_row = tmp;
1028 /* restore actual size info */
1029 gtk_cell_view_size_request (GTK_WIDGET (cell_view), &req);
1035 * gtk_cell_view_set_background_color:
1036 * @cell_view: a #GtkCellView
1037 * @color: the new background color
1039 * Sets the background color of @view.
1044 gtk_cell_view_set_background_color (GtkCellView *cell_view,
1045 const GdkColor *color)
1047 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1051 if (!cell_view->priv->background_set)
1053 cell_view->priv->background_set = TRUE;
1054 g_object_notify (G_OBJECT (cell_view), "background_set");
1057 cell_view->priv->background = *color;
1061 if (cell_view->priv->background_set)
1063 cell_view->priv->background_set = FALSE;
1064 g_object_notify (G_OBJECT (cell_view), "background_set");
1068 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1072 * gtk_cell_view_get_cell_renderers:
1073 * @cell_view: a #GtkCellView
1075 * Returns the cell renderers which have been added to @cell_view.
1077 * Return value: a list of cell renderers. The list, but not the
1078 * renderers has been newly allocated and should be freed with
1079 * g_list_free() when no longer needed.
1084 gtk_cell_view_get_cell_renderers (GtkCellView *cell_view)
1086 GList *retval = NULL, *list;
1088 g_return_val_if_fail (cell_view != NULL, NULL);
1090 gtk_cell_view_set_cell_data (cell_view);
1092 for (list = cell_view->priv->cell_list; list; list = list->next)
1094 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1096 retval = g_list_prepend (retval, info->cell);
1099 return g_list_reverse (retval);
1102 #define __GTK_CELL_VIEW_C__
1103 #include "gtkaliasdef.c"