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_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_finalize (GObject *object);
70 static void gtk_cell_view_style_set (GtkWidget *widget,
71 GtkStyle *previous_style);
72 static void gtk_cell_view_size_request (GtkWidget *widget,
73 GtkRequisition *requisition);
74 static void gtk_cell_view_size_allocate (GtkWidget *widget,
75 GtkAllocation *allocation);
76 static gboolean gtk_cell_view_expose (GtkWidget *widget,
77 GdkEventExpose *event);
78 static void gtk_cell_view_set_value (GtkCellView *cell_view,
79 GtkCellRenderer *renderer,
82 static GtkCellViewCellInfo *gtk_cell_view_get_cell_info (GtkCellView *cellview,
83 GtkCellRenderer *renderer);
84 static void gtk_cell_view_set_cell_data (GtkCellView *cell_view);
87 static void gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
88 GtkCellRenderer *renderer,
90 static void gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
91 GtkCellRenderer *renderer,
93 static void gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
94 GtkCellRenderer *renderer,
95 const gchar *attribute,
97 static void gtk_cell_view_cell_layout_clear (GtkCellLayout *layout);
98 static void gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
99 GtkCellRenderer *renderer);
100 static void gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
101 GtkCellRenderer *cell,
102 GtkCellLayoutDataFunc func,
104 GDestroyNotify destroy);
105 static void gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
106 GtkCellRenderer *cell,
110 #define GTK_CELL_VIEW_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_CELL_VIEW, GtkCellViewPrivate))
121 G_DEFINE_TYPE_WITH_CODE (GtkCellView, gtk_cell_view, GTK_TYPE_WIDGET,
122 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,
123 gtk_cell_view_cell_layout_init))
126 gtk_cell_view_class_init (GtkCellViewClass *klass)
128 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
129 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
131 gobject_class->get_property = gtk_cell_view_get_property;
132 gobject_class->set_property = gtk_cell_view_set_property;
133 gobject_class->finalize = gtk_cell_view_finalize;
135 widget_class->expose_event = gtk_cell_view_expose;
136 widget_class->size_allocate = gtk_cell_view_size_allocate;
137 widget_class->size_request = gtk_cell_view_size_request;
138 widget_class->style_set = gtk_cell_view_style_set;
141 g_object_class_install_property (gobject_class,
143 g_param_spec_string ("background",
144 P_("Background color name"),
145 P_("Background color as a string"),
147 GTK_PARAM_WRITABLE));
148 g_object_class_install_property (gobject_class,
150 g_param_spec_boxed ("background-gdk",
151 P_("Background color"),
152 P_("Background color as a GdkColor"),
154 GTK_PARAM_READWRITE));
159 * The model for cell view
163 g_object_class_install_property (gobject_class,
165 g_param_spec_object ("model",
166 P_("CellView model"),
167 P_("The model for cell view"),
169 GTK_PARAM_READWRITE));
171 #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))
173 ADD_SET_PROP ("background-set", PROP_BACKGROUND_SET,
174 P_("Background set"),
175 P_("Whether this tag affects the background color"));
177 g_type_class_add_private (gobject_class, sizeof (GtkCellViewPrivate));
181 gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface)
183 iface->pack_start = gtk_cell_view_cell_layout_pack_start;
184 iface->pack_end = gtk_cell_view_cell_layout_pack_end;
185 iface->clear = gtk_cell_view_cell_layout_clear;
186 iface->add_attribute = gtk_cell_view_cell_layout_add_attribute;
187 iface->set_cell_data_func = gtk_cell_view_cell_layout_set_cell_data_func;
188 iface->clear_attributes = gtk_cell_view_cell_layout_clear_attributes;
189 iface->reorder = gtk_cell_view_cell_layout_reorder;
193 gtk_cell_view_get_property (GObject *object,
198 GtkCellView *view = GTK_CELL_VIEW (object);
202 case PROP_BACKGROUND_GDK:
206 color = view->priv->background;
208 g_value_set_boxed (value, &color);
211 case PROP_BACKGROUND_SET:
212 g_value_set_boolean (value, view->priv->background_set);
215 g_value_set_object (value, view->priv->model);
218 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
224 gtk_cell_view_set_property (GObject *object,
229 GtkCellView *view = GTK_CELL_VIEW (object);
233 case PROP_BACKGROUND:
237 if (!g_value_get_string (value))
238 gtk_cell_view_set_background_color (view, NULL);
239 else if (gdk_color_parse (g_value_get_string (value), &color))
240 gtk_cell_view_set_background_color (view, &color);
242 g_warning ("Don't know color `%s'", g_value_get_string (value));
244 g_object_notify (object, "background-gdk");
247 case PROP_BACKGROUND_GDK:
248 gtk_cell_view_set_background_color (view, g_value_get_boxed (value));
250 case PROP_BACKGROUND_SET:
251 view->priv->background_set = g_value_get_boolean (value);
254 gtk_cell_view_set_model (view, g_value_get_object (value));
257 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
263 gtk_cell_view_init (GtkCellView *cellview)
265 GTK_WIDGET_SET_FLAGS (cellview, GTK_NO_WINDOW);
267 cellview->priv = GTK_CELL_VIEW_GET_PRIVATE (cellview);
271 gtk_cell_view_style_set (GtkWidget *widget,
272 GtkStyle *previous_style)
274 if (previous_style && GTK_WIDGET_REALIZED (widget))
275 gdk_window_set_background (widget->window,
276 &widget->style->base[GTK_WIDGET_STATE (widget)]);
280 gtk_cell_view_finalize (GObject *object)
282 GtkCellView *cellview = GTK_CELL_VIEW (object);
284 gtk_cell_view_cell_layout_clear (GTK_CELL_LAYOUT (cellview));
286 if (cellview->priv->model)
287 g_object_unref (cellview->priv->model);
289 if (cellview->priv->displayed_row)
290 gtk_tree_row_reference_free (cellview->priv->displayed_row);
292 (* G_OBJECT_CLASS (gtk_cell_view_parent_class)->finalize) (object);
296 gtk_cell_view_size_request (GtkWidget *widget,
297 GtkRequisition *requisition)
300 gboolean first_cell = TRUE;
301 GtkCellView *cellview;
303 cellview = GTK_CELL_VIEW (widget);
305 requisition->width = 0;
306 requisition->height = 0;
308 if (cellview->priv->displayed_row)
309 gtk_cell_view_set_cell_data (cellview);
311 for (i = cellview->priv->cell_list; i; i = i->next)
314 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
316 if (!info->cell->visible)
320 requisition->width += cellview->priv->spacing;
322 gtk_cell_renderer_get_size (info->cell, widget, NULL, NULL, NULL,
325 info->requested_width = width;
326 requisition->width += width;
327 requisition->height = MAX (requisition->height, height);
334 gtk_cell_view_size_allocate (GtkWidget *widget,
335 GtkAllocation *allocation)
338 gint expand_cell_count = 0;
339 gint full_requested_width = 0;
341 GtkCellView *cellview;
343 widget->allocation = *allocation;
345 cellview = GTK_CELL_VIEW (widget);
347 /* checking how much extra space we have */
348 for (i = cellview->priv->cell_list; i; i = i->next)
350 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
352 if (!info->cell->visible)
358 full_requested_width += info->requested_width;
361 extra_space = widget->allocation.width - full_requested_width;
364 else if (extra_space > 0 && expand_cell_count > 0)
365 extra_space /= expand_cell_count;
367 /* iterate list for PACK_START cells */
368 for (i = cellview->priv->cell_list; i; i = i->next)
370 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
372 if (info->pack == GTK_PACK_END)
375 if (!info->cell->visible)
378 info->real_width = info->requested_width + (info->expand?extra_space:0);
381 /* iterate list for PACK_END cells */
382 for (i = cellview->priv->cell_list; i; i = i->next)
384 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
386 if (info->pack == GTK_PACK_START)
389 if (!info->cell->visible)
392 info->real_width = info->requested_width + (info->expand?extra_space:0);
397 gtk_cell_view_expose (GtkWidget *widget,
398 GdkEventExpose *event)
401 GtkCellView *cellview;
403 GtkCellRendererState state;
404 gboolean rtl = (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL);
406 cellview = GTK_CELL_VIEW (widget);
408 if (! GTK_WIDGET_DRAWABLE (widget))
411 /* "blank" background */
412 if (cellview->priv->background_set)
414 cairo_t *cr = gdk_cairo_create (GTK_WIDGET (cellview)->window);
416 gdk_cairo_rectangle (cr, &widget->allocation);
417 cairo_set_source_rgb (cr,
418 cellview->priv->background.red / 65535.,
419 cellview->priv->background.green / 65535.,
420 cellview->priv->background.blue / 65535.);
426 /* set cell data (if available) */
427 if (cellview->priv->displayed_row)
428 gtk_cell_view_set_cell_data (cellview);
429 else if (cellview->priv->model)
433 area = widget->allocation;
435 /* we draw on our very own window, initialize x and y to zero */
436 area.x = widget->allocation.x + (rtl ? widget->allocation.width : 0);
437 area.y = widget->allocation.y;
439 if (GTK_WIDGET_STATE (widget) == GTK_STATE_PRELIGHT)
440 state = GTK_CELL_RENDERER_PRELIT;
445 for (i = cellview->priv->cell_list; i; i = i->next)
447 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
449 if (info->pack == GTK_PACK_END)
452 if (!info->cell->visible)
455 area.width = info->real_width;
457 area.x -= area.width;
459 gtk_cell_renderer_render (info->cell,
463 &area, &area, &event->area, state);
466 area.x += info->real_width;
469 area.x = rtl ? widget->allocation.x : (widget->allocation.x + widget->allocation.width);
472 for (i = cellview->priv->cell_list; i; i = i->next)
474 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
476 if (info->pack == GTK_PACK_START)
479 if (!info->cell->visible)
482 area.width = info->real_width;
484 area.x -= area.width;
486 gtk_cell_renderer_render (info->cell,
490 &area, &area, &event->area, state);
492 area.x += info->real_width;
498 static GtkCellViewCellInfo *
499 gtk_cell_view_get_cell_info (GtkCellView *cellview,
500 GtkCellRenderer *renderer)
504 for (i = cellview->priv->cell_list; i; i = i->next)
506 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
508 if (info->cell == renderer)
516 gtk_cell_view_set_cell_data (GtkCellView *cell_view)
522 g_return_if_fail (cell_view->priv->displayed_row != NULL);
524 path = gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
528 gtk_tree_model_get_iter (cell_view->priv->model, &iter, path);
529 gtk_tree_path_free (path);
531 for (i = cell_view->priv->cell_list; i; i = i->next)
534 GtkCellViewCellInfo *info = i->data;
536 g_object_freeze_notify (G_OBJECT (info->cell));
538 for (j = info->attributes; j && j->next; j = j->next->next)
540 gchar *property = j->data;
541 gint column = GPOINTER_TO_INT (j->next->data);
542 GValue value = {0, };
544 gtk_tree_model_get_value (cell_view->priv->model, &iter,
546 g_object_set_property (G_OBJECT (info->cell),
548 g_value_unset (&value);
552 (* info->func) (GTK_CELL_LAYOUT (cell_view),
554 cell_view->priv->model,
558 g_object_thaw_notify (G_OBJECT (info->cell));
562 /* GtkCellLayout implementation */
564 gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
565 GtkCellRenderer *renderer,
568 GtkCellViewCellInfo *info;
569 GtkCellView *cellview = GTK_CELL_VIEW (layout);
571 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
572 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
573 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
575 g_object_ref_sink (renderer);
577 info = g_new0 (GtkCellViewCellInfo, 1);
578 info->cell = renderer;
579 info->expand = expand ? TRUE : FALSE;
580 info->pack = GTK_PACK_START;
582 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
586 gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
587 GtkCellRenderer *renderer,
590 GtkCellViewCellInfo *info;
591 GtkCellView *cellview = GTK_CELL_VIEW (layout);
593 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
594 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
595 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
597 g_object_ref_sink (renderer);
599 info = g_new0 (GtkCellViewCellInfo, 1);
600 info->cell = renderer;
601 info->expand = expand ? TRUE : FALSE;
602 info->pack = GTK_PACK_END;
604 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
608 gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
609 GtkCellRenderer *renderer,
610 const gchar *attribute,
613 GtkCellViewCellInfo *info;
614 GtkCellView *cellview = GTK_CELL_VIEW (layout);
616 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
617 info = gtk_cell_view_get_cell_info (cellview, renderer);
618 g_return_if_fail (info != NULL);
620 info->attributes = g_slist_prepend (info->attributes,
621 GINT_TO_POINTER (column));
622 info->attributes = g_slist_prepend (info->attributes,
623 g_strdup (attribute));
627 gtk_cell_view_cell_layout_clear (GtkCellLayout *layout)
629 GtkCellView *cellview = GTK_CELL_VIEW (layout);
631 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
633 while (cellview->priv->cell_list)
635 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)cellview->priv->cell_list->data;
637 gtk_cell_view_cell_layout_clear_attributes (layout, info->cell);
638 g_object_unref (info->cell);
640 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
641 cellview->priv->cell_list);
646 gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
647 GtkCellRenderer *cell,
648 GtkCellLayoutDataFunc func,
650 GDestroyNotify destroy)
652 GtkCellView *cellview = GTK_CELL_VIEW (layout);
653 GtkCellViewCellInfo *info;
655 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
657 info = gtk_cell_view_get_cell_info (cellview, cell);
658 g_return_if_fail (info != NULL);
662 GDestroyNotify d = info->destroy;
664 info->destroy = NULL;
669 info->func_data = func_data;
670 info->destroy = destroy;
674 gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
675 GtkCellRenderer *renderer)
677 GtkCellViewCellInfo *info;
678 GtkCellView *cellview = GTK_CELL_VIEW (layout);
681 g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
682 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
684 info = gtk_cell_view_get_cell_info (cellview, renderer);
687 list = info->attributes;
688 while (list && list->next)
691 list = list->next->next;
694 g_slist_free (info->attributes);
695 info->attributes = NULL;
700 gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
701 GtkCellRenderer *cell,
705 GtkCellViewCellInfo *info;
706 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 (cell));
711 info = gtk_cell_view_get_cell_info (cellview, cell);
713 g_return_if_fail (info != NULL);
714 g_return_if_fail (position >= 0);
716 link = g_list_find (cellview->priv->cell_list, info);
718 g_return_if_fail (link != NULL);
720 cellview->priv->cell_list = g_list_remove_link (cellview->priv->cell_list,
722 cellview->priv->cell_list = g_list_insert (cellview->priv->cell_list,
725 gtk_widget_queue_draw (GTK_WIDGET (cellview));
731 * Creates a new #GtkCellView widget.
733 * Return value: A newly created #GtkCellView widget.
738 gtk_cell_view_new (void)
740 GtkCellView *cellview;
742 cellview = g_object_new (gtk_cell_view_get_type (), NULL);
744 return GTK_WIDGET (cellview);
748 * gtk_cell_view_new_with_text:
749 * @text: the text to display in the cell view
751 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
752 * to it, and makes its show @text.
754 * Return value: A newly created #GtkCellView widget.
759 gtk_cell_view_new_with_text (const gchar *text)
761 GtkCellView *cellview;
762 GtkCellRenderer *renderer;
763 GValue value = {0, };
765 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
767 renderer = gtk_cell_renderer_text_new ();
768 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
771 g_value_init (&value, G_TYPE_STRING);
772 g_value_set_string (&value, text);
773 gtk_cell_view_set_value (cellview, renderer, "text", &value);
774 g_value_unset (&value);
776 return GTK_WIDGET (cellview);
780 * gtk_cell_view_new_with_markup:
781 * @markup: the text to display in the cell view
783 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
784 * to it, and makes its show @markup. The text can text can be
785 * marked up with the <link linkend="PangoMarkupFormat">Pango text
786 * markup language</link>.
788 * Return value: A newly created #GtkCellView widget.
793 gtk_cell_view_new_with_markup (const gchar *markup)
795 GtkCellView *cellview;
796 GtkCellRenderer *renderer;
797 GValue value = {0, };
799 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
801 renderer = gtk_cell_renderer_text_new ();
802 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
805 g_value_init (&value, G_TYPE_STRING);
806 g_value_set_string (&value, markup);
807 gtk_cell_view_set_value (cellview, renderer, "markup", &value);
808 g_value_unset (&value);
810 return GTK_WIDGET (cellview);
814 * gtk_cell_view_new_with_pixbuf:
815 * @pixbuf: the image to display in the cell view
817 * Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf
818 * to it, and makes its show @pixbuf.
820 * Return value: A newly created #GtkCellView widget.
825 gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf)
827 GtkCellView *cellview;
828 GtkCellRenderer *renderer;
829 GValue value = {0, };
831 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
833 renderer = gtk_cell_renderer_pixbuf_new ();
834 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
837 g_value_init (&value, GDK_TYPE_PIXBUF);
838 g_value_set_object (&value, pixbuf);
839 gtk_cell_view_set_value (cellview, renderer, "pixbuf", &value);
840 g_value_unset (&value);
842 return GTK_WIDGET (cellview);
846 * gtk_cell_view_set_value:
847 * @cell_view: a #GtkCellView widget
848 * @renderer: one of the renderers of @cell_view
849 * @property: the name of the property of @renderer to set
850 * @value: the new value to set the property to
852 * Sets a property of a cell renderer of @cell_view, and
853 * makes sure the display of @cell_view is updated.
858 gtk_cell_view_set_value (GtkCellView *cell_view,
859 GtkCellRenderer *renderer,
863 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
864 g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
866 g_object_set_property (G_OBJECT (renderer), property, value);
868 /* force resize and redraw */
869 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
870 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
874 * gtk_cell_view_set_model:
875 * @cell_view: a #GtkCellView
876 * @model: a #GtkTreeModel
878 * Sets the model for @cell_view. If @cell_view already has a model
879 * set, it will remove it before setting the new model. If @model is
880 * %NULL, then it will unset the old model.
885 gtk_cell_view_set_model (GtkCellView *cell_view,
888 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
889 g_return_if_fail (GTK_IS_TREE_MODEL (model));
891 if (cell_view->priv->model)
893 if (cell_view->priv->displayed_row)
894 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
895 cell_view->priv->displayed_row = NULL;
897 g_object_unref (cell_view->priv->model);
898 cell_view->priv->model = NULL;
901 cell_view->priv->model = model;
903 if (cell_view->priv->model)
904 g_object_ref (cell_view->priv->model);
908 * gtk_cell_view_set_displayed_row:
909 * @cell_view: a #GtkCellView
910 * @path: a #GtkTreePath or %NULL to unset.
912 * Sets the row of the model that is currently displayed
913 * by the #GtkCellView. If the path is unset, then the
914 * contents of the cellview "stick" at their last value;
915 * this is not normally a desired result, but may be
916 * a needed intermediate state if say, the model for
917 * the #GtkCellView becomes temporarily empty.
922 gtk_cell_view_set_displayed_row (GtkCellView *cell_view,
925 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
926 g_return_if_fail (GTK_IS_TREE_MODEL (cell_view->priv->model));
928 if (cell_view->priv->displayed_row)
929 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
933 cell_view->priv->displayed_row =
934 gtk_tree_row_reference_new (cell_view->priv->model, path);
937 cell_view->priv->displayed_row = NULL;
939 /* force resize and redraw */
940 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
941 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
945 * gtk_cell_view_get_displayed_row:
946 * @cell_view: a #GtkCellView
948 * Returns a #GtkTreePath referring to the currently
949 * displayed row. If no row is currently displayed,
952 * Returns: the currently displayed row or %NULL
957 gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
959 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
961 if (!cell_view->priv->displayed_row)
964 return gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
968 * gtk_cell_view_get_size_of_row:
969 * @cell_view: a #GtkCellView
970 * @path: a #GtkTreePath
971 * @requisition: return location for the size
973 * Sets @requisition to the size needed by @cell_view to display
974 * the model row pointed to by @path.
976 * Return value: %TRUE
981 gtk_cell_view_get_size_of_row (GtkCellView *cell_view,
983 GtkRequisition *requisition)
985 GtkTreeRowReference *tmp;
988 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), FALSE);
989 g_return_val_if_fail (path != NULL, FALSE);
990 g_return_val_if_fail (requisition != NULL, FALSE);
992 tmp = cell_view->priv->displayed_row;
993 cell_view->priv->displayed_row =
994 gtk_tree_row_reference_new (cell_view->priv->model, path);
996 gtk_cell_view_size_request (GTK_WIDGET (cell_view), requisition);
998 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
999 cell_view->priv->displayed_row = tmp;
1001 /* restore actual size info */
1002 gtk_cell_view_size_request (GTK_WIDGET (cell_view), &req);
1008 * gtk_cell_view_set_background_color:
1009 * @cell_view: a #GtkCellView
1010 * @color: the new background color
1012 * Sets the background color of @view.
1017 gtk_cell_view_set_background_color (GtkCellView *cell_view,
1018 const GdkColor *color)
1020 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1024 if (!cell_view->priv->background_set)
1026 cell_view->priv->background_set = TRUE;
1027 g_object_notify (G_OBJECT (cell_view), "background-set");
1030 cell_view->priv->background = *color;
1034 if (cell_view->priv->background_set)
1036 cell_view->priv->background_set = FALSE;
1037 g_object_notify (G_OBJECT (cell_view), "background-set");
1041 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1045 * gtk_cell_view_get_cell_renderers:
1046 * @cell_view: a #GtkCellView
1048 * Returns the cell renderers which have been added to @cell_view.
1050 * Return value: a list of cell renderers. The list, but not the
1051 * renderers has been newly allocated and should be freed with
1052 * g_list_free() when no longer needed.
1057 gtk_cell_view_get_cell_renderers (GtkCellView *cell_view)
1059 GList *retval = NULL, *list;
1061 g_return_val_if_fail (cell_view != NULL, NULL);
1063 gtk_cell_view_set_cell_data (cell_view);
1065 for (list = cell_view->priv->cell_list; list; list = list->next)
1067 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1069 retval = g_list_prepend (retval, info->cell);
1072 return g_list_reverse (retval);
1075 #define __GTK_CELL_VIEW_C__
1076 #include "gtkaliasdef.c"