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 "gtkcellrenderertext.h"
26 #include "gtkcellrendererpixbuf.h"
27 #include "gtkprivate.h"
28 #include <gobject/gmarshal.h>
29 #include "gtkbuildable.h"
32 typedef struct _GtkCellViewCellInfo GtkCellViewCellInfo;
33 struct _GtkCellViewCellInfo
35 GtkCellRenderer *cell;
44 GtkCellLayoutDataFunc func;
46 GDestroyNotify destroy;
49 struct _GtkCellViewPrivate
52 GtkTreeRowReference *displayed_row;
57 gboolean background_set;
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_finalize (GObject *object);
71 static void gtk_cell_view_size_request (GtkWidget *widget,
72 GtkRequisition *requisition);
73 static void gtk_cell_view_size_allocate (GtkWidget *widget,
74 GtkAllocation *allocation);
75 static gboolean gtk_cell_view_expose (GtkWidget *widget,
76 GdkEventExpose *event);
77 static void gtk_cell_view_set_value (GtkCellView *cell_view,
78 GtkCellRenderer *renderer,
81 static GtkCellViewCellInfo *gtk_cell_view_get_cell_info (GtkCellView *cellview,
82 GtkCellRenderer *renderer);
83 static void gtk_cell_view_set_cell_data (GtkCellView *cell_view);
86 static void gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
87 GtkCellRenderer *renderer,
89 static void gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
90 GtkCellRenderer *renderer,
92 static void gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
93 GtkCellRenderer *renderer,
94 const gchar *attribute,
96 static void gtk_cell_view_cell_layout_clear (GtkCellLayout *layout);
97 static void gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
98 GtkCellRenderer *renderer);
99 static void gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
100 GtkCellRenderer *cell,
101 GtkCellLayoutDataFunc func,
103 GDestroyNotify destroy);
104 static void gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
105 GtkCellRenderer *cell,
107 static GList * gtk_cell_view_cell_layout_get_cells (GtkCellLayout *layout);
110 static void gtk_cell_view_buildable_init (GtkBuildableIface *iface);
111 static gboolean gtk_cell_view_buildable_custom_tag_start (GtkBuildable *buildable,
114 const gchar *tagname,
115 GMarkupParser *parser,
117 static void gtk_cell_view_buildable_custom_tag_end (GtkBuildable *buildable,
120 const gchar *tagname,
123 static GtkBuildableIface *parent_buildable_iface;
135 G_DEFINE_TYPE_WITH_CODE (GtkCellView, gtk_cell_view, GTK_TYPE_WIDGET,
136 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,
137 gtk_cell_view_cell_layout_init)
138 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
139 gtk_cell_view_buildable_init))
142 gtk_cell_view_class_init (GtkCellViewClass *klass)
144 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
145 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
147 gobject_class->get_property = gtk_cell_view_get_property;
148 gobject_class->set_property = gtk_cell_view_set_property;
149 gobject_class->finalize = gtk_cell_view_finalize;
151 widget_class->expose_event = gtk_cell_view_expose;
152 widget_class->size_allocate = gtk_cell_view_size_allocate;
153 widget_class->size_request = gtk_cell_view_size_request;
156 g_object_class_install_property (gobject_class,
158 g_param_spec_string ("background",
159 P_("Background color name"),
160 P_("Background color as a string"),
162 GTK_PARAM_WRITABLE));
163 g_object_class_install_property (gobject_class,
165 g_param_spec_boxed ("background-gdk",
166 P_("Background color"),
167 P_("Background color as a GdkColor"),
169 GTK_PARAM_READWRITE));
174 * The model for cell view
178 g_object_class_install_property (gobject_class,
180 g_param_spec_object ("model",
181 P_("CellView model"),
182 P_("The model for cell view"),
184 GTK_PARAM_READWRITE));
186 #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))
188 ADD_SET_PROP ("background-set", PROP_BACKGROUND_SET,
189 P_("Background set"),
190 P_("Whether this tag affects the background color"));
192 g_type_class_add_private (gobject_class, sizeof (GtkCellViewPrivate));
196 gtk_cell_view_buildable_init (GtkBuildableIface *iface)
198 parent_buildable_iface = g_type_interface_peek_parent (iface);
199 iface->add_child = _gtk_cell_layout_buildable_add_child;
200 iface->custom_tag_start = gtk_cell_view_buildable_custom_tag_start;
201 iface->custom_tag_end = gtk_cell_view_buildable_custom_tag_end;
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;
214 iface->get_cells = gtk_cell_view_cell_layout_get_cells;
218 gtk_cell_view_get_property (GObject *object,
223 GtkCellView *view = GTK_CELL_VIEW (object);
227 case PROP_BACKGROUND_GDK:
231 color = view->priv->background;
233 g_value_set_boxed (value, &color);
236 case PROP_BACKGROUND_SET:
237 g_value_set_boolean (value, view->priv->background_set);
240 g_value_set_object (value, view->priv->model);
243 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
249 gtk_cell_view_set_property (GObject *object,
254 GtkCellView *view = GTK_CELL_VIEW (object);
258 case PROP_BACKGROUND:
262 if (!g_value_get_string (value))
263 gtk_cell_view_set_background_color (view, NULL);
264 else if (gdk_color_parse (g_value_get_string (value), &color))
265 gtk_cell_view_set_background_color (view, &color);
267 g_warning ("Don't know color `%s'", g_value_get_string (value));
269 g_object_notify (object, "background-gdk");
272 case PROP_BACKGROUND_GDK:
273 gtk_cell_view_set_background_color (view, g_value_get_boxed (value));
275 case PROP_BACKGROUND_SET:
276 view->priv->background_set = g_value_get_boolean (value);
279 gtk_cell_view_set_model (view, g_value_get_object (value));
282 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
288 gtk_cell_view_init (GtkCellView *cellview)
290 GtkCellViewPrivate *priv;
292 cellview->priv = G_TYPE_INSTANCE_GET_PRIVATE (cellview,
295 priv = cellview->priv;
297 gtk_widget_set_has_window (GTK_WIDGET (cellview), FALSE);
301 gtk_cell_view_finalize (GObject *object)
303 GtkCellView *cellview = GTK_CELL_VIEW (object);
305 gtk_cell_view_cell_layout_clear (GTK_CELL_LAYOUT (cellview));
307 if (cellview->priv->model)
308 g_object_unref (cellview->priv->model);
310 if (cellview->priv->displayed_row)
311 gtk_tree_row_reference_free (cellview->priv->displayed_row);
313 G_OBJECT_CLASS (gtk_cell_view_parent_class)->finalize (object);
317 gtk_cell_view_size_request (GtkWidget *widget,
318 GtkRequisition *requisition)
321 gboolean first_cell = TRUE;
322 GtkCellView *cellview;
324 cellview = GTK_CELL_VIEW (widget);
326 requisition->width = 0;
327 requisition->height = 0;
329 if (cellview->priv->displayed_row)
330 gtk_cell_view_set_cell_data (cellview);
332 for (i = cellview->priv->cell_list; i; i = i->next)
335 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
337 if (!gtk_cell_renderer_get_visible (info->cell))
341 requisition->width += cellview->priv->spacing;
343 gtk_cell_renderer_get_size (info->cell, widget, NULL, NULL, NULL,
346 info->requested_width = width;
347 requisition->width += width;
348 requisition->height = MAX (requisition->height, height);
355 gtk_cell_view_size_allocate (GtkWidget *widget,
356 GtkAllocation *allocation)
359 gint expand_cell_count = 0;
360 gint full_requested_width = 0;
362 GtkCellView *cellview;
364 widget->allocation = *allocation;
366 cellview = GTK_CELL_VIEW (widget);
368 /* checking how much extra space we have */
369 for (i = cellview->priv->cell_list; i; i = i->next)
371 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
373 if (!gtk_cell_renderer_get_visible (info->cell))
379 full_requested_width += info->requested_width;
382 extra_space = widget->allocation.width - full_requested_width;
385 else if (extra_space > 0 && expand_cell_count > 0)
386 extra_space /= expand_cell_count;
388 for (i = cellview->priv->cell_list; i; i = i->next)
390 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
392 if (!gtk_cell_renderer_get_visible (info->cell))
395 info->real_width = info->requested_width +
396 (info->expand ? extra_space : 0);
401 gtk_cell_view_expose (GtkWidget *widget,
402 GdkEventExpose *event)
405 GtkCellView *cellview;
407 GtkCellRendererState state;
408 gboolean rtl = (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL);
410 cellview = GTK_CELL_VIEW (widget);
412 if (!gtk_widget_is_drawable (widget))
415 /* "blank" background */
416 if (cellview->priv->background_set)
418 cairo_t *cr = gdk_cairo_create (GTK_WIDGET (cellview)->window);
420 gdk_cairo_rectangle (cr, &widget->allocation);
421 cairo_set_source_rgb (cr,
422 cellview->priv->background.red / 65535.,
423 cellview->priv->background.green / 65535.,
424 cellview->priv->background.blue / 65535.);
430 /* set cell data (if available) */
431 if (cellview->priv->displayed_row)
432 gtk_cell_view_set_cell_data (cellview);
433 else if (cellview->priv->model)
437 area = widget->allocation;
439 /* we draw on our very own window, initialize x and y to zero */
440 area.x = widget->allocation.x + (rtl ? widget->allocation.width : 0);
441 area.y = widget->allocation.y;
443 if (gtk_widget_get_state (widget) == GTK_STATE_PRELIGHT)
444 state = GTK_CELL_RENDERER_PRELIT;
445 else if (gtk_widget_get_state (widget) == GTK_STATE_INSENSITIVE)
446 state = GTK_CELL_RENDERER_INSENSITIVE;
451 for (i = cellview->priv->cell_list; i; i = i->next)
453 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
455 if (info->pack == GTK_PACK_END)
458 if (!gtk_cell_renderer_get_visible (info->cell))
461 area.width = info->real_width;
463 area.x -= area.width;
465 gtk_cell_renderer_render (info->cell,
469 &area, &area, &event->area, state);
472 area.x += info->real_width;
475 area.x = rtl ? widget->allocation.x : (widget->allocation.x + widget->allocation.width);
478 for (i = cellview->priv->cell_list; i; i = i->next)
480 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
482 if (info->pack == GTK_PACK_START)
485 if (!gtk_cell_renderer_get_visible (info->cell))
488 area.width = info->real_width;
490 area.x -= area.width;
492 gtk_cell_renderer_render (info->cell,
496 &area, &area, &event->area, state);
498 area.x += info->real_width;
504 static GtkCellViewCellInfo *
505 gtk_cell_view_get_cell_info (GtkCellView *cellview,
506 GtkCellRenderer *renderer)
510 for (i = cellview->priv->cell_list; i; i = i->next)
512 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
514 if (info->cell == renderer)
522 gtk_cell_view_set_cell_data (GtkCellView *cell_view)
528 g_return_if_fail (cell_view->priv->displayed_row != NULL);
530 path = gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
534 gtk_tree_model_get_iter (cell_view->priv->model, &iter, path);
535 gtk_tree_path_free (path);
537 for (i = cell_view->priv->cell_list; i; i = i->next)
540 GtkCellViewCellInfo *info = i->data;
542 g_object_freeze_notify (G_OBJECT (info->cell));
544 for (j = info->attributes; j && j->next; j = j->next->next)
546 gchar *property = j->data;
547 gint column = GPOINTER_TO_INT (j->next->data);
548 GValue value = {0, };
550 gtk_tree_model_get_value (cell_view->priv->model, &iter,
552 g_object_set_property (G_OBJECT (info->cell),
554 g_value_unset (&value);
558 (* info->func) (GTK_CELL_LAYOUT (cell_view),
560 cell_view->priv->model,
564 g_object_thaw_notify (G_OBJECT (info->cell));
568 /* GtkCellLayout implementation */
570 gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
571 GtkCellRenderer *renderer,
574 GtkCellViewCellInfo *info;
575 GtkCellView *cellview = GTK_CELL_VIEW (layout);
577 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
579 g_object_ref_sink (renderer);
581 info = g_slice_new0 (GtkCellViewCellInfo);
582 info->cell = renderer;
583 info->expand = expand ? TRUE : FALSE;
584 info->pack = GTK_PACK_START;
586 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
590 gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
591 GtkCellRenderer *renderer,
594 GtkCellViewCellInfo *info;
595 GtkCellView *cellview = GTK_CELL_VIEW (layout);
597 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
599 g_object_ref_sink (renderer);
601 info = g_slice_new0 (GtkCellViewCellInfo);
602 info->cell = renderer;
603 info->expand = expand ? TRUE : FALSE;
604 info->pack = GTK_PACK_END;
606 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
610 gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
611 GtkCellRenderer *renderer,
612 const gchar *attribute,
615 GtkCellViewCellInfo *info;
616 GtkCellView *cellview = GTK_CELL_VIEW (layout);
618 info = gtk_cell_view_get_cell_info (cellview, renderer);
619 g_return_if_fail (info != NULL);
621 info->attributes = g_slist_prepend (info->attributes,
622 GINT_TO_POINTER (column));
623 info->attributes = g_slist_prepend (info->attributes,
624 g_strdup (attribute));
628 gtk_cell_view_cell_layout_clear (GtkCellLayout *layout)
630 GtkCellView *cellview = GTK_CELL_VIEW (layout);
632 while (cellview->priv->cell_list)
634 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)cellview->priv->cell_list->data;
636 gtk_cell_view_cell_layout_clear_attributes (layout, info->cell);
637 g_object_unref (info->cell);
638 g_slice_free (GtkCellViewCellInfo, info);
639 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
640 cellview->priv->cell_list);
645 gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
646 GtkCellRenderer *cell,
647 GtkCellLayoutDataFunc func,
649 GDestroyNotify destroy)
651 GtkCellView *cellview = GTK_CELL_VIEW (layout);
652 GtkCellViewCellInfo *info;
654 info = gtk_cell_view_get_cell_info (cellview, cell);
655 g_return_if_fail (info != NULL);
659 GDestroyNotify d = info->destroy;
661 info->destroy = NULL;
666 info->func_data = func_data;
667 info->destroy = destroy;
671 gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
672 GtkCellRenderer *renderer)
674 GtkCellView *cellview = GTK_CELL_VIEW (layout);
675 GtkCellViewCellInfo *info;
678 info = gtk_cell_view_get_cell_info (cellview, renderer);
681 list = info->attributes;
682 while (list && list->next)
685 list = list->next->next;
688 g_slist_free (info->attributes);
689 info->attributes = NULL;
694 gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
695 GtkCellRenderer *cell,
698 GtkCellView *cellview = GTK_CELL_VIEW (layout);
699 GtkCellViewCellInfo *info;
702 info = gtk_cell_view_get_cell_info (cellview, cell);
704 g_return_if_fail (info != NULL);
705 g_return_if_fail (position >= 0);
707 link = g_list_find (cellview->priv->cell_list, info);
709 g_return_if_fail (link != NULL);
711 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
713 cellview->priv->cell_list = g_list_insert (cellview->priv->cell_list,
716 gtk_widget_queue_draw (GTK_WIDGET (cellview));
722 * Creates a new #GtkCellView widget.
724 * Return value: A newly created #GtkCellView widget.
729 gtk_cell_view_new (void)
731 GtkCellView *cellview;
733 cellview = g_object_new (gtk_cell_view_get_type (), NULL);
735 return GTK_WIDGET (cellview);
739 * gtk_cell_view_new_with_text:
740 * @text: the text to display in the cell view
742 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
743 * to it, and makes its show @text.
745 * Return value: A newly created #GtkCellView widget.
750 gtk_cell_view_new_with_text (const gchar *text)
752 GtkCellView *cellview;
753 GtkCellRenderer *renderer;
754 GValue value = {0, };
756 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
758 renderer = gtk_cell_renderer_text_new ();
759 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
762 g_value_init (&value, G_TYPE_STRING);
763 g_value_set_string (&value, text);
764 gtk_cell_view_set_value (cellview, renderer, "text", &value);
765 g_value_unset (&value);
767 return GTK_WIDGET (cellview);
771 * gtk_cell_view_new_with_markup:
772 * @markup: the text to display in the cell view
774 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
775 * to it, and makes it show @markup. The text can be
776 * marked up with the <link linkend="PangoMarkupFormat">Pango text
777 * markup language</link>.
779 * Return value: A newly created #GtkCellView widget.
784 gtk_cell_view_new_with_markup (const gchar *markup)
786 GtkCellView *cellview;
787 GtkCellRenderer *renderer;
788 GValue value = {0, };
790 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
792 renderer = gtk_cell_renderer_text_new ();
793 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
796 g_value_init (&value, G_TYPE_STRING);
797 g_value_set_string (&value, markup);
798 gtk_cell_view_set_value (cellview, renderer, "markup", &value);
799 g_value_unset (&value);
801 return GTK_WIDGET (cellview);
805 * gtk_cell_view_new_with_pixbuf:
806 * @pixbuf: the image to display in the cell view
808 * Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf
809 * to it, and makes its show @pixbuf.
811 * Return value: A newly created #GtkCellView widget.
816 gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf)
818 GtkCellView *cellview;
819 GtkCellRenderer *renderer;
820 GValue value = {0, };
822 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
824 renderer = gtk_cell_renderer_pixbuf_new ();
825 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
828 g_value_init (&value, GDK_TYPE_PIXBUF);
829 g_value_set_object (&value, pixbuf);
830 gtk_cell_view_set_value (cellview, renderer, "pixbuf", &value);
831 g_value_unset (&value);
833 return GTK_WIDGET (cellview);
837 * gtk_cell_view_set_value:
838 * @cell_view: a #GtkCellView widget
839 * @renderer: one of the renderers of @cell_view
840 * @property: the name of the property of @renderer to set
841 * @value: the new value to set the property to
843 * Sets a property of a cell renderer of @cell_view, and
844 * makes sure the display of @cell_view is updated.
849 gtk_cell_view_set_value (GtkCellView *cell_view,
850 GtkCellRenderer *renderer,
854 g_object_set_property (G_OBJECT (renderer), property, value);
856 /* force resize and redraw */
857 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
858 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
862 * gtk_cell_view_set_model:
863 * @cell_view: a #GtkCellView
864 * @model: (allow-none): a #GtkTreeModel
866 * Sets the model for @cell_view. If @cell_view already has a model
867 * set, it will remove it before setting the new model. If @model is
868 * %NULL, then it will unset the old model.
873 gtk_cell_view_set_model (GtkCellView *cell_view,
876 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
877 g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model));
879 if (cell_view->priv->model)
881 if (cell_view->priv->displayed_row)
882 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
883 cell_view->priv->displayed_row = NULL;
885 g_object_unref (cell_view->priv->model);
886 cell_view->priv->model = NULL;
889 cell_view->priv->model = model;
891 if (cell_view->priv->model)
892 g_object_ref (cell_view->priv->model);
896 * gtk_cell_view_get_model:
897 * @cell_view: a #GtkCellView
899 * Returns the model for @cell_view. If no model is used %NULL is
902 * Returns: a #GtkTreeModel used or %NULL
907 gtk_cell_view_get_model (GtkCellView *cell_view)
909 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
911 return cell_view->priv->model;
915 * gtk_cell_view_set_displayed_row:
916 * @cell_view: a #GtkCellView
917 * @path: (allow-none): a #GtkTreePath or %NULL to unset.
919 * Sets the row of the model that is currently displayed
920 * by the #GtkCellView. If the path is unset, then the
921 * contents of the cellview "stick" at their last value;
922 * this is not normally a desired result, but may be
923 * a needed intermediate state if say, the model for
924 * the #GtkCellView becomes temporarily empty.
929 gtk_cell_view_set_displayed_row (GtkCellView *cell_view,
932 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
933 g_return_if_fail (GTK_IS_TREE_MODEL (cell_view->priv->model));
935 if (cell_view->priv->displayed_row)
936 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
940 cell_view->priv->displayed_row =
941 gtk_tree_row_reference_new (cell_view->priv->model, path);
944 cell_view->priv->displayed_row = NULL;
946 /* force resize and redraw */
947 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
948 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
952 * gtk_cell_view_get_displayed_row:
953 * @cell_view: a #GtkCellView
955 * Returns a #GtkTreePath referring to the currently
956 * displayed row. If no row is currently displayed,
959 * Returns: the currently displayed row or %NULL
964 gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
966 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
968 if (!cell_view->priv->displayed_row)
971 return gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
975 * gtk_cell_view_get_size_of_row:
976 * @cell_view: a #GtkCellView
977 * @path: a #GtkTreePath
978 * @requisition: return location for the size
980 * Sets @requisition to the size needed by @cell_view to display
981 * the model row pointed to by @path.
983 * Return value: %TRUE
988 gtk_cell_view_get_size_of_row (GtkCellView *cell_view,
990 GtkRequisition *requisition)
992 GtkTreeRowReference *tmp;
995 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), FALSE);
996 g_return_val_if_fail (path != NULL, FALSE);
997 g_return_val_if_fail (requisition != NULL, FALSE);
999 tmp = cell_view->priv->displayed_row;
1000 cell_view->priv->displayed_row =
1001 gtk_tree_row_reference_new (cell_view->priv->model, path);
1003 gtk_cell_view_size_request (GTK_WIDGET (cell_view), requisition);
1005 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1006 cell_view->priv->displayed_row = tmp;
1008 /* restore actual size info */
1009 gtk_cell_view_size_request (GTK_WIDGET (cell_view), &req);
1015 * gtk_cell_view_set_background_color:
1016 * @cell_view: a #GtkCellView
1017 * @color: the new background color
1019 * Sets the background color of @view.
1024 gtk_cell_view_set_background_color (GtkCellView *cell_view,
1025 const GdkColor *color)
1027 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1031 if (!cell_view->priv->background_set)
1033 cell_view->priv->background_set = TRUE;
1034 g_object_notify (G_OBJECT (cell_view), "background-set");
1037 cell_view->priv->background = *color;
1041 if (cell_view->priv->background_set)
1043 cell_view->priv->background_set = FALSE;
1044 g_object_notify (G_OBJECT (cell_view), "background-set");
1048 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1052 gtk_cell_view_cell_layout_get_cells (GtkCellLayout *layout)
1054 GtkCellView *cell_view = GTK_CELL_VIEW (layout);
1055 GList *retval = NULL, *list;
1057 g_return_val_if_fail (cell_view != NULL, NULL);
1059 gtk_cell_view_set_cell_data (cell_view);
1061 for (list = cell_view->priv->cell_list; list; list = list->next)
1063 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1065 retval = g_list_prepend (retval, info->cell);
1068 return g_list_reverse (retval);
1072 gtk_cell_view_buildable_custom_tag_start (GtkBuildable *buildable,
1073 GtkBuilder *builder,
1075 const gchar *tagname,
1076 GMarkupParser *parser,
1079 if (parent_buildable_iface->custom_tag_start &&
1080 parent_buildable_iface->custom_tag_start (buildable, builder, child,
1081 tagname, parser, data))
1084 return _gtk_cell_layout_buildable_custom_tag_start (buildable, builder, child,
1085 tagname, parser, data);
1089 gtk_cell_view_buildable_custom_tag_end (GtkBuildable *buildable,
1090 GtkBuilder *builder,
1092 const gchar *tagname,
1095 if (strcmp (tagname, "attributes") == 0)
1096 _gtk_cell_layout_buildable_custom_tag_end (buildable, builder, child, tagname,
1098 else if (parent_buildable_iface->custom_tag_end)
1099 parent_buildable_iface->custom_tag_end (buildable, builder, child, tagname,