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 "gtksizerequest.h"
29 #include <gobject/gmarshal.h>
30 #include "gtkbuildable.h"
33 typedef struct _GtkCellViewCellInfo GtkCellViewCellInfo;
34 struct _GtkCellViewCellInfo
36 GtkCellRenderer *cell;
46 GtkCellLayoutDataFunc func;
48 GDestroyNotify destroy;
51 struct _GtkCellViewPrivate
54 GtkTreeRowReference *displayed_row;
59 gboolean background_set;
63 static void gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface);
64 static void gtk_cell_view_get_property (GObject *object,
68 static void gtk_cell_view_set_property (GObject *object,
72 static void gtk_cell_view_finalize (GObject *object);
73 static void gtk_cell_view_size_allocate (GtkWidget *widget,
74 GtkAllocation *allocation);
75 static gboolean gtk_cell_view_draw (GtkWidget *widget,
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 void gtk_cell_view_get_preferred_width (GtkWidget *widget,
126 static void gtk_cell_view_get_preferred_height (GtkWidget *widget,
129 static void gtk_cell_view_get_preferred_width_for_height (GtkWidget *widget,
133 static void gtk_cell_view_get_preferred_height_for_width (GtkWidget *widget,
138 static GtkBuildableIface *parent_buildable_iface;
146 PROP_BACKGROUND_RGBA,
151 G_DEFINE_TYPE_WITH_CODE (GtkCellView, gtk_cell_view, GTK_TYPE_WIDGET,
152 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,
153 gtk_cell_view_cell_layout_init)
154 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
155 gtk_cell_view_buildable_init))
159 gtk_cell_view_class_init (GtkCellViewClass *klass)
161 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
162 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
164 gobject_class->get_property = gtk_cell_view_get_property;
165 gobject_class->set_property = gtk_cell_view_set_property;
166 gobject_class->finalize = gtk_cell_view_finalize;
168 widget_class->draw = gtk_cell_view_draw;
169 widget_class->size_allocate = gtk_cell_view_size_allocate;
170 widget_class->get_preferred_width = gtk_cell_view_get_preferred_width;
171 widget_class->get_preferred_height = gtk_cell_view_get_preferred_height;
172 widget_class->get_preferred_width_for_height = gtk_cell_view_get_preferred_width_for_height;
173 widget_class->get_preferred_height_for_width = gtk_cell_view_get_preferred_height_for_width;
176 g_object_class_install_property (gobject_class,
178 g_param_spec_string ("background",
179 P_("Background color name"),
180 P_("Background color as a string"),
182 GTK_PARAM_WRITABLE));
183 g_object_class_install_property (gobject_class,
185 g_param_spec_boxed ("background-gdk",
186 P_("Background color"),
187 P_("Background color as a GdkColor"),
189 GTK_PARAM_READWRITE));
191 * GtkCellView:background-rgba
193 * The background color as a #GdkRGBA
197 g_object_class_install_property (gobject_class,
198 PROP_BACKGROUND_RGBA,
199 g_param_spec_boxed ("background-rgba",
200 P_("Background RGBA color"),
201 P_("Background color as a GdkRGBA"),
203 GTK_PARAM_READWRITE));
208 * The model for cell view
212 g_object_class_install_property (gobject_class,
214 g_param_spec_object ("model",
215 P_("CellView model"),
216 P_("The model for cell view"),
218 GTK_PARAM_READWRITE));
220 #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))
222 ADD_SET_PROP ("background-set", PROP_BACKGROUND_SET,
223 P_("Background set"),
224 P_("Whether this tag affects the background color"));
226 g_type_class_add_private (gobject_class, sizeof (GtkCellViewPrivate));
230 gtk_cell_view_buildable_init (GtkBuildableIface *iface)
232 parent_buildable_iface = g_type_interface_peek_parent (iface);
233 iface->add_child = _gtk_cell_layout_buildable_add_child;
234 iface->custom_tag_start = gtk_cell_view_buildable_custom_tag_start;
235 iface->custom_tag_end = gtk_cell_view_buildable_custom_tag_end;
239 gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface)
241 iface->pack_start = gtk_cell_view_cell_layout_pack_start;
242 iface->pack_end = gtk_cell_view_cell_layout_pack_end;
243 iface->clear = gtk_cell_view_cell_layout_clear;
244 iface->add_attribute = gtk_cell_view_cell_layout_add_attribute;
245 iface->set_cell_data_func = gtk_cell_view_cell_layout_set_cell_data_func;
246 iface->clear_attributes = gtk_cell_view_cell_layout_clear_attributes;
247 iface->reorder = gtk_cell_view_cell_layout_reorder;
248 iface->get_cells = gtk_cell_view_cell_layout_get_cells;
252 gtk_cell_view_get_property (GObject *object,
257 GtkCellView *view = GTK_CELL_VIEW (object);
261 case PROP_BACKGROUND_GDK:
265 color.red = (guint) (view->priv->background.red * 65535);
266 color.green = (guint) (view->priv->background.green * 65535);
267 color.blue = (guint) (view->priv->background.blue * 65535);
270 g_value_set_boxed (value, &color);
273 case PROP_BACKGROUND_RGBA:
274 g_value_set_boxed (value, &view->priv->background);
276 case PROP_BACKGROUND_SET:
277 g_value_set_boolean (value, view->priv->background_set);
280 g_value_set_object (value, view->priv->model);
283 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
289 gtk_cell_view_set_property (GObject *object,
294 GtkCellView *view = GTK_CELL_VIEW (object);
298 case PROP_BACKGROUND:
302 if (!g_value_get_string (value))
303 gtk_cell_view_set_background_color (view, NULL);
304 else if (gdk_color_parse (g_value_get_string (value), &color))
305 gtk_cell_view_set_background_color (view, &color);
307 g_warning ("Don't know color `%s'", g_value_get_string (value));
309 g_object_notify (object, "background-gdk");
312 case PROP_BACKGROUND_GDK:
313 gtk_cell_view_set_background_color (view, g_value_get_boxed (value));
315 case PROP_BACKGROUND_RGBA:
316 gtk_cell_view_set_background_rgba (view, g_value_get_boxed (value));
318 case PROP_BACKGROUND_SET:
319 view->priv->background_set = g_value_get_boolean (value);
322 gtk_cell_view_set_model (view, g_value_get_object (value));
325 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
331 gtk_cell_view_init (GtkCellView *cellview)
333 GtkCellViewPrivate *priv;
335 cellview->priv = G_TYPE_INSTANCE_GET_PRIVATE (cellview,
338 priv = cellview->priv;
340 gtk_widget_set_has_window (GTK_WIDGET (cellview), FALSE);
344 gtk_cell_view_finalize (GObject *object)
346 GtkCellView *cellview = GTK_CELL_VIEW (object);
348 gtk_cell_view_cell_layout_clear (GTK_CELL_LAYOUT (cellview));
350 if (cellview->priv->model)
351 g_object_unref (cellview->priv->model);
353 if (cellview->priv->displayed_row)
354 gtk_tree_row_reference_free (cellview->priv->displayed_row);
356 G_OBJECT_CLASS (gtk_cell_view_parent_class)->finalize (object);
360 gtk_cell_view_size_allocate (GtkWidget *widget,
361 GtkAllocation *allocation)
363 GtkCellView *cellview;
364 GtkRequestedSize *sizes;
366 gint n_visible_cells, n_expand_cells;
367 gint avail_width = 0;
368 gint extra_per_cell, extra_extra, i;
369 gboolean first_cell = TRUE;
371 gtk_widget_set_allocation (widget, allocation);
373 cellview = GTK_CELL_VIEW (widget);
375 avail_width = allocation->width;
377 /* Count visible/expand children */
378 for (n_visible_cells = 0, n_expand_cells = 0, list = cellview->priv->cell_list;
379 list; list = list->next)
381 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
389 sizes = g_new0 (GtkRequestedSize, n_visible_cells);
391 /* checking how much extra space we have */
392 for (i = 0, list = cellview->priv->cell_list; list; list = list->next)
394 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
396 if (!gtk_cell_renderer_get_visible (info->cell))
399 sizes[i].data = info;
400 sizes[i].minimum_size = info->requested_width;
401 sizes[i].natural_size = info->natural_width;
404 avail_width -= cellview->priv->spacing;
406 avail_width -= sizes[i].minimum_size;
413 avail_width = gtk_distribute_natural_allocation (MAX (0, avail_width), n_visible_cells, sizes);
415 /* Deal with any expand space... */
416 if (n_expand_cells > 0)
418 extra_per_cell = avail_width / n_expand_cells;
419 extra_extra = avail_width % n_expand_cells;
422 /* Everything just left-aligned if no cells expand */
423 extra_per_cell = extra_extra = 0;
425 for (i = 0, list = cellview->priv->cell_list; list; list = list->next)
427 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
429 if (!gtk_cell_renderer_get_visible (info->cell))
432 info->real_width = sizes[i].minimum_size;
436 info->real_width += extra_per_cell;
445 /* increment index into sizes for visible children */
453 gtk_cell_view_draw (GtkWidget *widget,
457 GtkCellView *cellview;
459 GtkCellRendererState state;
460 gboolean rtl = (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL);
464 cellview = GTK_CELL_VIEW (widget);
469 area.width = width = gtk_widget_get_allocated_width (widget);
470 area.height = gtk_widget_get_allocated_height (widget);
472 /* "blank" background */
473 if (cellview->priv->background_set)
475 gdk_cairo_rectangle (cr, &area);
476 gdk_cairo_set_source_rgba (cr, &cellview->priv->background);
480 /* set cell data (if available) */
481 if (cellview->priv->displayed_row)
482 gtk_cell_view_set_cell_data (cellview);
483 else if (cellview->priv->model)
486 if (gtk_widget_get_state (widget) == GTK_STATE_PRELIGHT)
487 state = GTK_CELL_RENDERER_PRELIT;
488 else if (gtk_widget_get_state (widget) == GTK_STATE_INSENSITIVE)
489 state = GTK_CELL_RENDERER_INSENSITIVE;
493 for (packing = GTK_PACK_START; packing <= GTK_PACK_END; ++packing)
495 if (packing == GTK_PACK_START)
496 area.x = rtl ? width : 0;
498 area.x = rtl ? 0 : width;
500 for (list = cellview->priv->cell_list; list; list = list->next)
502 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
504 if (info->pack != packing)
507 if (!gtk_cell_renderer_get_visible (info->cell))
510 area.width = info->real_width;
512 if ((packing == GTK_PACK_START && rtl) ||
513 (packing == GTK_PACK_END && !rtl))
514 area.x -= area.width;
516 gtk_cell_renderer_render (info->cell,
520 &area, &area, state);
522 if ((packing == GTK_PACK_START && !rtl) ||
523 (packing == GTK_PACK_END && rtl))
525 area.x += area.width;
526 area.x += cellview->priv->spacing;
529 area.x -= cellview->priv->spacing;
536 static GtkCellViewCellInfo *
537 gtk_cell_view_get_cell_info (GtkCellView *cellview,
538 GtkCellRenderer *renderer)
542 for (i = cellview->priv->cell_list; i; i = i->next)
544 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
546 if (info->cell == renderer)
554 gtk_cell_view_set_cell_data (GtkCellView *cell_view)
560 g_return_if_fail (cell_view->priv->displayed_row != NULL);
562 path = gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
566 gtk_tree_model_get_iter (cell_view->priv->model, &iter, path);
567 gtk_tree_path_free (path);
569 for (i = cell_view->priv->cell_list; i; i = i->next)
572 GtkCellViewCellInfo *info = i->data;
574 g_object_freeze_notify (G_OBJECT (info->cell));
576 for (j = info->attributes; j && j->next; j = j->next->next)
578 gchar *property = j->data;
579 gint column = GPOINTER_TO_INT (j->next->data);
580 GValue value = {0, };
582 gtk_tree_model_get_value (cell_view->priv->model, &iter,
584 g_object_set_property (G_OBJECT (info->cell),
586 g_value_unset (&value);
590 (* info->func) (GTK_CELL_LAYOUT (cell_view),
592 cell_view->priv->model,
596 g_object_thaw_notify (G_OBJECT (info->cell));
600 /* GtkCellLayout implementation */
602 gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
603 GtkCellRenderer *renderer,
606 GtkCellViewCellInfo *info;
607 GtkCellView *cellview = GTK_CELL_VIEW (layout);
609 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
611 g_object_ref_sink (renderer);
613 info = g_slice_new0 (GtkCellViewCellInfo);
614 info->cell = renderer;
615 info->expand = expand ? TRUE : FALSE;
616 info->pack = GTK_PACK_START;
618 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
620 gtk_widget_queue_resize (GTK_WIDGET (cellview));
624 gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
625 GtkCellRenderer *renderer,
628 GtkCellViewCellInfo *info;
629 GtkCellView *cellview = GTK_CELL_VIEW (layout);
631 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
633 g_object_ref_sink (renderer);
635 info = g_slice_new0 (GtkCellViewCellInfo);
636 info->cell = renderer;
637 info->expand = expand ? TRUE : FALSE;
638 info->pack = GTK_PACK_END;
640 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
642 gtk_widget_queue_resize (GTK_WIDGET (cellview));
646 gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
647 GtkCellRenderer *renderer,
648 const gchar *attribute,
651 GtkCellViewCellInfo *info;
652 GtkCellView *cellview = GTK_CELL_VIEW (layout);
654 info = gtk_cell_view_get_cell_info (cellview, renderer);
655 g_return_if_fail (info != NULL);
657 info->attributes = g_slist_prepend (info->attributes,
658 GINT_TO_POINTER (column));
659 info->attributes = g_slist_prepend (info->attributes,
660 g_strdup (attribute));
664 gtk_cell_view_cell_layout_clear (GtkCellLayout *layout)
666 GtkCellView *cellview = GTK_CELL_VIEW (layout);
668 while (cellview->priv->cell_list)
670 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)cellview->priv->cell_list->data;
672 gtk_cell_view_cell_layout_clear_attributes (layout, info->cell);
673 g_object_unref (info->cell);
674 g_slice_free (GtkCellViewCellInfo, info);
675 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
676 cellview->priv->cell_list);
681 gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
682 GtkCellRenderer *cell,
683 GtkCellLayoutDataFunc func,
685 GDestroyNotify destroy)
687 GtkCellView *cellview = GTK_CELL_VIEW (layout);
688 GtkCellViewCellInfo *info;
690 info = gtk_cell_view_get_cell_info (cellview, cell);
691 g_return_if_fail (info != NULL);
695 GDestroyNotify d = info->destroy;
697 info->destroy = NULL;
702 info->func_data = func_data;
703 info->destroy = destroy;
707 gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
708 GtkCellRenderer *renderer)
710 GtkCellView *cellview = GTK_CELL_VIEW (layout);
711 GtkCellViewCellInfo *info;
714 info = gtk_cell_view_get_cell_info (cellview, renderer);
717 list = info->attributes;
718 while (list && list->next)
721 list = list->next->next;
724 g_slist_free (info->attributes);
725 info->attributes = NULL;
730 gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
731 GtkCellRenderer *cell,
734 GtkCellView *cellview = GTK_CELL_VIEW (layout);
735 GtkCellViewCellInfo *info;
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_delete_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 it show @markup. The 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_object_set_property (G_OBJECT (renderer), property, value);
892 /* force resize and redraw */
893 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
894 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
898 * gtk_cell_view_set_model:
899 * @cell_view: a #GtkCellView
900 * @model: (allow-none): a #GtkTreeModel
902 * Sets the model for @cell_view. If @cell_view already has a model
903 * set, it will remove it before setting the new model. If @model is
904 * %NULL, then it will unset the old model.
909 gtk_cell_view_set_model (GtkCellView *cell_view,
912 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
913 g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model));
915 if (cell_view->priv->model)
917 if (cell_view->priv->displayed_row)
918 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
919 cell_view->priv->displayed_row = NULL;
921 g_object_unref (cell_view->priv->model);
922 cell_view->priv->model = NULL;
925 cell_view->priv->model = model;
927 if (cell_view->priv->model)
928 g_object_ref (cell_view->priv->model);
932 * gtk_cell_view_get_model:
933 * @cell_view: a #GtkCellView
935 * Returns the model for @cell_view. If no model is used %NULL is
938 * Returns: (transfer none): a #GtkTreeModel used or %NULL
943 gtk_cell_view_get_model (GtkCellView *cell_view)
945 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
947 return cell_view->priv->model;
951 * gtk_cell_view_set_displayed_row:
952 * @cell_view: a #GtkCellView
953 * @path: (allow-none): a #GtkTreePath or %NULL to unset.
955 * Sets the row of the model that is currently displayed
956 * by the #GtkCellView. If the path is unset, then the
957 * contents of the cellview "stick" at their last value;
958 * this is not normally a desired result, but may be
959 * a needed intermediate state if say, the model for
960 * the #GtkCellView becomes temporarily empty.
965 gtk_cell_view_set_displayed_row (GtkCellView *cell_view,
968 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
969 g_return_if_fail (GTK_IS_TREE_MODEL (cell_view->priv->model));
971 if (cell_view->priv->displayed_row)
972 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
976 cell_view->priv->displayed_row =
977 gtk_tree_row_reference_new (cell_view->priv->model, path);
980 cell_view->priv->displayed_row = NULL;
982 /* force resize and redraw */
983 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
984 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
988 * gtk_cell_view_get_displayed_row:
989 * @cell_view: a #GtkCellView
991 * Returns a #GtkTreePath referring to the currently
992 * displayed row. If no row is currently displayed,
995 * Returns: the currently displayed row or %NULL
1000 gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
1002 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
1004 if (!cell_view->priv->displayed_row)
1007 return gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
1011 * gtk_cell_view_get_size_of_row:
1012 * @cell_view: a #GtkCellView
1013 * @path: a #GtkTreePath
1014 * @requisition: return location for the size
1016 * Sets @requisition to the size needed by @cell_view to display
1017 * the model row pointed to by @path.
1019 * Return value: %TRUE
1023 * Deprecated: 3.0: Use gtk_cell_view_get_desired_width_of_row() and
1024 * gtk_cell_view_get_desired_height_for_width_of_row() instead.
1027 gtk_cell_view_get_size_of_row (GtkCellView *cell_view,
1029 GtkRequisition *requisition)
1033 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), FALSE);
1034 g_return_val_if_fail (path != NULL, FALSE);
1036 /* Return the minimum height for the minimum width */
1037 gtk_cell_view_get_desired_width_of_row (cell_view, path, &req.width, NULL);
1038 gtk_cell_view_get_desired_height_for_width_of_row (cell_view, path, req.width, &req.height, NULL);
1048 * gtk_cell_view_get_desired_width_of_row:
1049 * @cell_view: a #GtkCellView
1050 * @path: a #GtkTreePath
1051 * @minimum_size: location to store the minimum size
1052 * @natural_size: location to store the natural size
1054 * Sets @minimum_size and @natural_size to the width desired by @cell_view
1055 * to display the model row pointed to by @path.
1060 gtk_cell_view_get_desired_width_of_row (GtkCellView *cell_view,
1065 GtkTreeRowReference *tmp;
1067 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1068 g_return_if_fail (path != NULL);
1069 g_return_if_fail (minimum_size != NULL || natural_size != NULL);
1071 tmp = cell_view->priv->displayed_row;
1072 cell_view->priv->displayed_row =
1073 gtk_tree_row_reference_new (cell_view->priv->model, path);
1075 gtk_cell_view_get_preferred_width (GTK_WIDGET (cell_view), minimum_size, natural_size);
1077 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1078 cell_view->priv->displayed_row = tmp;
1080 /* Restore active size (this will restore the cellrenderer info->width/requested_width's) */
1081 gtk_cell_view_get_preferred_width (GTK_WIDGET (cell_view), NULL, NULL);
1086 * gtk_cell_view_get_desired_height_for_width_of_row:
1087 * @cell_view: a #GtkCellView
1088 * @path: a #GtkTreePath
1089 * @avail_size: available width
1090 * @minimum_size: location to store the minimum height
1091 * @natural_size: location to store the natural height
1093 * Sets @minimum_size and @natural_size to the height desired by @cell_view
1094 * if it were allocated a width of @avail_size to display the model row
1095 * pointed to by @path.
1100 gtk_cell_view_get_desired_height_for_width_of_row (GtkCellView *cell_view,
1106 GtkTreeRowReference *tmp;
1108 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1109 g_return_if_fail (path != NULL);
1110 g_return_if_fail (minimum_size != NULL || natural_size != NULL);
1112 tmp = cell_view->priv->displayed_row;
1113 cell_view->priv->displayed_row =
1114 gtk_tree_row_reference_new (cell_view->priv->model, path);
1116 /* Then get the collective height_for_width based on the cached values */
1117 gtk_cell_view_get_preferred_height_for_width (GTK_WIDGET (cell_view), avail_size, minimum_size, natural_size);
1119 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1120 cell_view->priv->displayed_row = tmp;
1122 /* Restore active size (this will restore the cellrenderer info->width/requested_width's) */
1123 gtk_cell_view_get_preferred_width (GTK_WIDGET (cell_view), NULL, NULL);
1127 * gtk_cell_view_set_background_color:
1128 * @cell_view: a #GtkCellView
1129 * @color: the new background color
1131 * Sets the background color of @view.
1136 gtk_cell_view_set_background_color (GtkCellView *cell_view,
1137 const GdkColor *color)
1139 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1143 if (!cell_view->priv->background_set)
1145 cell_view->priv->background_set = TRUE;
1146 g_object_notify (G_OBJECT (cell_view), "background-set");
1149 cell_view->priv->background.red = color->red / 65535.;
1150 cell_view->priv->background.green = color->green / 65535.;
1151 cell_view->priv->background.blue = color->blue / 65535.;
1152 cell_view->priv->background.alpha = 1;
1156 if (cell_view->priv->background_set)
1158 cell_view->priv->background_set = FALSE;
1159 g_object_notify (G_OBJECT (cell_view), "background-set");
1163 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1167 * gtk_cell_view_set_background_rgba:
1168 * @cell_view: a #GtkCellView
1169 * @rgba: the new background color
1171 * Sets the background color of @cell_view.
1176 gtk_cell_view_set_background_rgba (GtkCellView *cell_view,
1177 const GdkRGBA *rgba)
1179 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1183 if (!cell_view->priv->background_set)
1185 cell_view->priv->background_set = TRUE;
1186 g_object_notify (G_OBJECT (cell_view), "background-set");
1189 cell_view->priv->background = *rgba;
1193 if (cell_view->priv->background_set)
1195 cell_view->priv->background_set = FALSE;
1196 g_object_notify (G_OBJECT (cell_view), "background-set");
1200 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1204 gtk_cell_view_cell_layout_get_cells (GtkCellLayout *layout)
1206 GtkCellView *cell_view = GTK_CELL_VIEW (layout);
1207 GList *retval = NULL, *list;
1209 g_return_val_if_fail (cell_view != NULL, NULL);
1211 gtk_cell_view_set_cell_data (cell_view);
1213 for (list = cell_view->priv->cell_list; list; list = list->next)
1215 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1217 retval = g_list_prepend (retval, info->cell);
1220 return g_list_reverse (retval);
1224 gtk_cell_view_buildable_custom_tag_start (GtkBuildable *buildable,
1225 GtkBuilder *builder,
1227 const gchar *tagname,
1228 GMarkupParser *parser,
1231 if (parent_buildable_iface->custom_tag_start &&
1232 parent_buildable_iface->custom_tag_start (buildable, builder, child,
1233 tagname, parser, data))
1236 return _gtk_cell_layout_buildable_custom_tag_start (buildable, builder, child,
1237 tagname, parser, data);
1241 gtk_cell_view_buildable_custom_tag_end (GtkBuildable *buildable,
1242 GtkBuilder *builder,
1244 const gchar *tagname,
1247 if (strcmp (tagname, "attributes") == 0)
1248 _gtk_cell_layout_buildable_custom_tag_end (buildable, builder, child, tagname,
1250 else if (parent_buildable_iface->custom_tag_end)
1251 parent_buildable_iface->custom_tag_end (buildable, builder, child, tagname,
1256 gtk_cell_view_get_preferred_width (GtkWidget *widget,
1261 gint cell_min, cell_nat;
1262 gboolean first_cell = TRUE;
1263 GtkCellView *cellview = GTK_CELL_VIEW (widget);
1264 gint minimum, natural;
1266 minimum = natural = 0;
1268 if (cellview->priv->displayed_row)
1269 gtk_cell_view_set_cell_data (cellview);
1271 for (list = cellview->priv->cell_list; list; list = list->next)
1273 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1275 if (gtk_cell_renderer_get_visible (info->cell))
1280 minimum += cellview->priv->spacing;
1281 natural += cellview->priv->spacing;
1284 gtk_cell_renderer_get_preferred_width (info->cell,
1285 GTK_WIDGET (cellview), &cell_min, &cell_nat);
1287 info->requested_width = cell_min;
1288 info->natural_width = cell_nat;
1290 minimum += info->requested_width;
1291 natural += info->natural_width;
1298 *minimum_size = minimum;
1301 *natural_size = natural;
1305 gtk_cell_view_get_preferred_height (GtkWidget *widget,
1311 /* CellViews only need to respond to height-for-width mode (cellview is pretty much
1312 * an implementation detail of GtkComboBox) */
1313 gtk_cell_view_get_preferred_width (widget, &minimum_width, NULL);
1314 gtk_cell_view_get_preferred_height_for_width (widget, minimum_width, minimum_size, natural_size);
1318 gtk_cell_view_get_preferred_width_for_height (GtkWidget *widget,
1323 /* CellViews only need to respond to height-for-width mode (cellview is pretty much
1324 * an implementation detail of GtkComboBox) */
1325 gtk_cell_view_get_preferred_width (widget, minimum_size, natural_size);
1329 gtk_cell_view_get_preferred_height_for_width (GtkWidget *widget,
1334 GtkCellView *cellview = GTK_CELL_VIEW (widget);
1336 GtkRequestedSize *sizes;
1338 gint minimum, natural, avail_size;
1339 gboolean first_cell = TRUE;
1340 gint n_expand_cells = 0;
1341 gint extra_per_cell, extra_extra, i;
1343 minimum = natural = 0;
1344 avail_size = for_size;
1346 array = g_array_new (0, TRUE, sizeof (GtkRequestedSize));
1348 if (cellview->priv->displayed_row)
1349 gtk_cell_view_set_cell_data (cellview);
1351 /* First allocate the right width to all cells */
1352 for (list = cellview->priv->cell_list; list; list = list->next)
1354 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1356 if (gtk_cell_renderer_get_visible (info->cell))
1358 GtkRequestedSize requested;
1360 gtk_cell_renderer_get_preferred_width (GTK_CELL_RENDERER (info->cell),
1361 GTK_WIDGET (cellview),
1362 &requested.minimum_size,
1363 &requested.natural_size);
1365 requested.data = info;
1366 g_array_append_val (array, requested);
1368 avail_size -= requested.minimum_size;
1371 avail_size -= cellview->priv->spacing;
1380 sizes = (GtkRequestedSize *)array->data;
1381 avail_size = gtk_distribute_natural_allocation (MAX (0, avail_size), array->len, sizes);
1383 /* Deal with any expand space... */
1384 if (n_expand_cells > 0)
1386 extra_per_cell = avail_size / n_expand_cells;
1387 extra_extra = avail_size % n_expand_cells;
1390 /* Everything just left-aligned if no cells expand */
1391 extra_per_cell = extra_extra = 0;
1393 /* Now get the height for the real width of each cell */
1394 for (i = 0, list = cellview->priv->cell_list; list; list = list->next)
1396 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1397 gint cell_minimum, cell_natural;
1399 if (gtk_cell_renderer_get_visible (info->cell))
1401 gint cell_width = sizes[i].minimum_size;
1403 g_assert (sizes[i].data == info);
1407 cell_width += extra_per_cell;
1415 /* Get the height for the real width of this cell */
1416 gtk_cell_renderer_get_preferred_height_for_width (GTK_CELL_RENDERER (info->cell),
1417 GTK_WIDGET (widget),
1418 cell_width, &cell_minimum, &cell_natural);
1420 minimum = MAX (minimum, cell_minimum);
1421 natural = MAX (natural, cell_natural);
1423 /* increment sizes[] index for visible cells */
1428 g_array_free (array, TRUE);
1431 *minimum_size = minimum;
1433 *natural_size = natural;