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 "gtksizerequest.h"
28 #include "gtkcellsizerequest.h"
29 #include "gtkprivate.h"
30 #include <gobject/gmarshal.h>
31 #include "gtkbuildable.h"
34 typedef struct _GtkCellViewCellInfo GtkCellViewCellInfo;
35 struct _GtkCellViewCellInfo
37 GtkCellRenderer *cell;
47 GtkCellLayoutDataFunc func;
49 GDestroyNotify destroy;
52 struct _GtkCellViewPrivate
55 GtkTreeRowReference *displayed_row;
60 gboolean background_set;
64 static void gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface);
65 static void gtk_cell_view_get_property (GObject *object,
69 static void gtk_cell_view_set_property (GObject *object,
73 static void gtk_cell_view_finalize (GObject *object);
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,
108 static GList * gtk_cell_view_cell_layout_get_cells (GtkCellLayout *layout);
111 static void gtk_cell_view_buildable_init (GtkBuildableIface *iface);
112 static gboolean gtk_cell_view_buildable_custom_tag_start (GtkBuildable *buildable,
115 const gchar *tagname,
116 GMarkupParser *parser,
118 static void gtk_cell_view_buildable_custom_tag_end (GtkBuildable *buildable,
121 const gchar *tagname,
124 static void gtk_cell_view_size_request_init (GtkSizeRequestIface *iface);
125 static void gtk_cell_view_get_width (GtkSizeRequest *widget,
128 static void gtk_cell_view_get_height (GtkSizeRequest *widget,
131 static void gtk_cell_view_get_width_for_height (GtkSizeRequest *widget,
135 static void gtk_cell_view_get_height_for_width (GtkSizeRequest *widget,
140 static GtkBuildableIface *parent_buildable_iface;
152 G_DEFINE_TYPE_WITH_CODE (GtkCellView, gtk_cell_view, GTK_TYPE_WIDGET,
153 G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,
154 gtk_cell_view_cell_layout_init)
155 G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
156 gtk_cell_view_buildable_init)
157 G_IMPLEMENT_INTERFACE (GTK_TYPE_SIZE_REQUEST,
158 gtk_cell_view_size_request_init))
162 gtk_cell_view_class_init (GtkCellViewClass *klass)
164 GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
165 GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
167 gobject_class->get_property = gtk_cell_view_get_property;
168 gobject_class->set_property = gtk_cell_view_set_property;
169 gobject_class->finalize = gtk_cell_view_finalize;
171 widget_class->expose_event = gtk_cell_view_expose;
172 widget_class->size_allocate = gtk_cell_view_size_allocate;
175 g_object_class_install_property (gobject_class,
177 g_param_spec_string ("background",
178 P_("Background color name"),
179 P_("Background color as a string"),
181 GTK_PARAM_WRITABLE));
182 g_object_class_install_property (gobject_class,
184 g_param_spec_boxed ("background-gdk",
185 P_("Background color"),
186 P_("Background color as a GdkColor"),
188 GTK_PARAM_READWRITE));
193 * The model for cell view
197 g_object_class_install_property (gobject_class,
199 g_param_spec_object ("model",
200 P_("CellView model"),
201 P_("The model for cell view"),
203 GTK_PARAM_READWRITE));
205 #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))
207 ADD_SET_PROP ("background-set", PROP_BACKGROUND_SET,
208 P_("Background set"),
209 P_("Whether this tag affects the background color"));
211 g_type_class_add_private (gobject_class, sizeof (GtkCellViewPrivate));
215 gtk_cell_view_buildable_init (GtkBuildableIface *iface)
217 parent_buildable_iface = g_type_interface_peek_parent (iface);
218 iface->add_child = _gtk_cell_layout_buildable_add_child;
219 iface->custom_tag_start = gtk_cell_view_buildable_custom_tag_start;
220 iface->custom_tag_end = gtk_cell_view_buildable_custom_tag_end;
224 gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface)
226 iface->pack_start = gtk_cell_view_cell_layout_pack_start;
227 iface->pack_end = gtk_cell_view_cell_layout_pack_end;
228 iface->clear = gtk_cell_view_cell_layout_clear;
229 iface->add_attribute = gtk_cell_view_cell_layout_add_attribute;
230 iface->set_cell_data_func = gtk_cell_view_cell_layout_set_cell_data_func;
231 iface->clear_attributes = gtk_cell_view_cell_layout_clear_attributes;
232 iface->reorder = gtk_cell_view_cell_layout_reorder;
233 iface->get_cells = gtk_cell_view_cell_layout_get_cells;
237 gtk_cell_view_get_property (GObject *object,
242 GtkCellView *view = GTK_CELL_VIEW (object);
246 case PROP_BACKGROUND_GDK:
250 color = view->priv->background;
252 g_value_set_boxed (value, &color);
255 case PROP_BACKGROUND_SET:
256 g_value_set_boolean (value, view->priv->background_set);
259 g_value_set_object (value, view->priv->model);
262 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
268 gtk_cell_view_set_property (GObject *object,
273 GtkCellView *view = GTK_CELL_VIEW (object);
277 case PROP_BACKGROUND:
281 if (!g_value_get_string (value))
282 gtk_cell_view_set_background_color (view, NULL);
283 else if (gdk_color_parse (g_value_get_string (value), &color))
284 gtk_cell_view_set_background_color (view, &color);
286 g_warning ("Don't know color `%s'", g_value_get_string (value));
288 g_object_notify (object, "background-gdk");
291 case PROP_BACKGROUND_GDK:
292 gtk_cell_view_set_background_color (view, g_value_get_boxed (value));
294 case PROP_BACKGROUND_SET:
295 view->priv->background_set = g_value_get_boolean (value);
298 gtk_cell_view_set_model (view, g_value_get_object (value));
301 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
307 gtk_cell_view_init (GtkCellView *cellview)
309 GtkCellViewPrivate *priv;
311 cellview->priv = G_TYPE_INSTANCE_GET_PRIVATE (cellview,
314 priv = cellview->priv;
316 gtk_widget_set_has_window (GTK_WIDGET (cellview), FALSE);
320 gtk_cell_view_finalize (GObject *object)
322 GtkCellView *cellview = GTK_CELL_VIEW (object);
324 gtk_cell_view_cell_layout_clear (GTK_CELL_LAYOUT (cellview));
326 if (cellview->priv->model)
327 g_object_unref (cellview->priv->model);
329 if (cellview->priv->displayed_row)
330 gtk_tree_row_reference_free (cellview->priv->displayed_row);
332 G_OBJECT_CLASS (gtk_cell_view_parent_class)->finalize (object);
336 gtk_cell_view_size_allocate (GtkWidget *widget,
337 GtkAllocation *allocation)
339 GtkCellView *cellview;
340 GtkRequestedSize *sizes;
342 gint n_visible_cells, n_expand_cells;
343 gint avail_width = 0;
344 gint extra_per_cell, extra_extra, i;
345 gboolean first_cell = TRUE;
347 gtk_widget_set_allocation (widget, allocation);
349 cellview = GTK_CELL_VIEW (widget);
351 avail_width = allocation->width;
353 /* Count visible/expand children */
354 for (n_visible_cells = 0, n_expand_cells = 0, list = cellview->priv->cell_list;
355 list; list = list->next)
357 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
365 sizes = g_new0 (GtkRequestedSize, n_visible_cells);
367 /* checking how much extra space we have */
368 for (i = 0, list = cellview->priv->cell_list; list; list = list->next)
370 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
372 if (!gtk_cell_renderer_get_visible (info->cell))
375 sizes[i].data = info;
376 sizes[i].minimum_size = info->requested_width;
377 sizes[i].natural_size = info->natural_width;
380 avail_width -= cellview->priv->spacing;
382 avail_width -= sizes[i].minimum_size;
389 avail_width = gtk_distribute_natural_allocation (MAX (0, avail_width), n_visible_cells, sizes);
391 /* Deal with any expand space... */
392 if (n_expand_cells > 0)
394 extra_per_cell = avail_width / n_expand_cells;
395 extra_extra = avail_width % n_expand_cells;
398 /* Everything just left-aligned if no cells expand */
399 extra_per_cell = extra_extra = 0;
401 for (i = 0, list = cellview->priv->cell_list; list; list = list->next)
403 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
405 if (!gtk_cell_renderer_get_visible (info->cell))
408 info->real_width = sizes[i].minimum_size;
412 info->real_width += extra_per_cell;
421 /* increment index into sizes for visible children */
429 gtk_cell_view_expose (GtkWidget *widget,
430 GdkEventExpose *event)
432 GtkAllocation allocation;
434 GtkCellView *cellview;
436 GtkCellRendererState state;
437 gboolean rtl = (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL);
440 cellview = GTK_CELL_VIEW (widget);
442 if (!gtk_widget_is_drawable (widget))
445 gtk_widget_get_allocation (widget, &allocation);
447 /* "blank" background */
448 if (cellview->priv->background_set)
450 cairo_t *cr = gdk_cairo_create (gtk_widget_get_window (GTK_WIDGET (cellview)));
452 gdk_cairo_rectangle (cr, &allocation);
453 cairo_set_source_rgb (cr,
454 cellview->priv->background.red / 65535.,
455 cellview->priv->background.green / 65535.,
456 cellview->priv->background.blue / 65535.);
462 /* set cell data (if available) */
463 if (cellview->priv->displayed_row)
464 gtk_cell_view_set_cell_data (cellview);
465 else if (cellview->priv->model)
471 /* we draw on our very own window, initialize x and y to zero */
472 area.y = allocation.y;
474 if (gtk_widget_get_state (widget) == GTK_STATE_PRELIGHT)
475 state = GTK_CELL_RENDERER_PRELIT;
476 else if (gtk_widget_get_state (widget) == GTK_STATE_INSENSITIVE)
477 state = GTK_CELL_RENDERER_INSENSITIVE;
481 for (packing = GTK_PACK_START; packing <= GTK_PACK_END; ++packing)
483 if (packing == GTK_PACK_START)
484 area.x = allocation.x + (rtl ? allocation.width : 0);
486 area.x = rtl ? allocation.x : (allocation.x + allocation.width);
488 for (list = cellview->priv->cell_list; list; list = list->next)
490 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
492 if (info->pack != packing)
495 if (!gtk_cell_renderer_get_visible (info->cell))
498 area.width = info->real_width;
500 if ((packing == GTK_PACK_START && rtl) ||
501 (packing == GTK_PACK_END && !rtl))
502 area.x -= area.width;
504 gtk_cell_renderer_render (info->cell,
508 &area, &area, &event->area, state);
510 if ((packing == GTK_PACK_START && !rtl) ||
511 (packing == GTK_PACK_END && rtl))
513 area.x += area.width;
514 area.x += cellview->priv->spacing;
517 area.x -= cellview->priv->spacing;
524 static GtkCellViewCellInfo *
525 gtk_cell_view_get_cell_info (GtkCellView *cellview,
526 GtkCellRenderer *renderer)
530 for (i = cellview->priv->cell_list; i; i = i->next)
532 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
534 if (info->cell == renderer)
542 gtk_cell_view_set_cell_data (GtkCellView *cell_view)
548 g_return_if_fail (cell_view->priv->displayed_row != NULL);
550 path = gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
554 gtk_tree_model_get_iter (cell_view->priv->model, &iter, path);
555 gtk_tree_path_free (path);
557 for (i = cell_view->priv->cell_list; i; i = i->next)
560 GtkCellViewCellInfo *info = i->data;
562 g_object_freeze_notify (G_OBJECT (info->cell));
564 for (j = info->attributes; j && j->next; j = j->next->next)
566 gchar *property = j->data;
567 gint column = GPOINTER_TO_INT (j->next->data);
568 GValue value = {0, };
570 gtk_tree_model_get_value (cell_view->priv->model, &iter,
572 g_object_set_property (G_OBJECT (info->cell),
574 g_value_unset (&value);
578 (* info->func) (GTK_CELL_LAYOUT (cell_view),
580 cell_view->priv->model,
584 g_object_thaw_notify (G_OBJECT (info->cell));
588 /* GtkCellLayout implementation */
590 gtk_cell_view_cell_layout_pack_start (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_START;
606 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
608 gtk_widget_queue_resize (GTK_WIDGET (cellview));
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_cell_view_get_cell_info (cellview, renderer));
621 g_object_ref_sink (renderer);
623 info = g_slice_new0 (GtkCellViewCellInfo);
624 info->cell = renderer;
625 info->expand = expand ? TRUE : FALSE;
626 info->pack = GTK_PACK_END;
628 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
630 gtk_widget_queue_resize (GTK_WIDGET (cellview));
634 gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
635 GtkCellRenderer *renderer,
636 const gchar *attribute,
639 GtkCellViewCellInfo *info;
640 GtkCellView *cellview = GTK_CELL_VIEW (layout);
642 info = gtk_cell_view_get_cell_info (cellview, renderer);
643 g_return_if_fail (info != NULL);
645 info->attributes = g_slist_prepend (info->attributes,
646 GINT_TO_POINTER (column));
647 info->attributes = g_slist_prepend (info->attributes,
648 g_strdup (attribute));
652 gtk_cell_view_cell_layout_clear (GtkCellLayout *layout)
654 GtkCellView *cellview = GTK_CELL_VIEW (layout);
656 while (cellview->priv->cell_list)
658 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)cellview->priv->cell_list->data;
660 gtk_cell_view_cell_layout_clear_attributes (layout, info->cell);
661 g_object_unref (info->cell);
662 g_slice_free (GtkCellViewCellInfo, info);
663 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
664 cellview->priv->cell_list);
669 gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
670 GtkCellRenderer *cell,
671 GtkCellLayoutDataFunc func,
673 GDestroyNotify destroy)
675 GtkCellView *cellview = GTK_CELL_VIEW (layout);
676 GtkCellViewCellInfo *info;
678 info = gtk_cell_view_get_cell_info (cellview, cell);
679 g_return_if_fail (info != NULL);
683 GDestroyNotify d = info->destroy;
685 info->destroy = NULL;
690 info->func_data = func_data;
691 info->destroy = destroy;
695 gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
696 GtkCellRenderer *renderer)
698 GtkCellView *cellview = GTK_CELL_VIEW (layout);
699 GtkCellViewCellInfo *info;
702 info = gtk_cell_view_get_cell_info (cellview, renderer);
705 list = info->attributes;
706 while (list && list->next)
709 list = list->next->next;
712 g_slist_free (info->attributes);
713 info->attributes = NULL;
718 gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
719 GtkCellRenderer *cell,
722 GtkCellView *cellview = GTK_CELL_VIEW (layout);
723 GtkCellViewCellInfo *info;
726 info = gtk_cell_view_get_cell_info (cellview, cell);
728 g_return_if_fail (info != NULL);
729 g_return_if_fail (position >= 0);
731 link = g_list_find (cellview->priv->cell_list, info);
733 g_return_if_fail (link != NULL);
735 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
737 cellview->priv->cell_list = g_list_insert (cellview->priv->cell_list,
740 gtk_widget_queue_draw (GTK_WIDGET (cellview));
746 * Creates a new #GtkCellView widget.
748 * Return value: A newly created #GtkCellView widget.
753 gtk_cell_view_new (void)
755 GtkCellView *cellview;
757 cellview = g_object_new (gtk_cell_view_get_type (), NULL);
759 return GTK_WIDGET (cellview);
763 * gtk_cell_view_new_with_text:
764 * @text: the text to display in the cell view
766 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
767 * to it, and makes its show @text.
769 * Return value: A newly created #GtkCellView widget.
774 gtk_cell_view_new_with_text (const gchar *text)
776 GtkCellView *cellview;
777 GtkCellRenderer *renderer;
778 GValue value = {0, };
780 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
782 renderer = gtk_cell_renderer_text_new ();
783 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
786 g_value_init (&value, G_TYPE_STRING);
787 g_value_set_string (&value, text);
788 gtk_cell_view_set_value (cellview, renderer, "text", &value);
789 g_value_unset (&value);
791 return GTK_WIDGET (cellview);
795 * gtk_cell_view_new_with_markup:
796 * @markup: the text to display in the cell view
798 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
799 * to it, and makes it show @markup. The text can be
800 * marked up with the <link linkend="PangoMarkupFormat">Pango text
801 * markup language</link>.
803 * Return value: A newly created #GtkCellView widget.
808 gtk_cell_view_new_with_markup (const gchar *markup)
810 GtkCellView *cellview;
811 GtkCellRenderer *renderer;
812 GValue value = {0, };
814 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
816 renderer = gtk_cell_renderer_text_new ();
817 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
820 g_value_init (&value, G_TYPE_STRING);
821 g_value_set_string (&value, markup);
822 gtk_cell_view_set_value (cellview, renderer, "markup", &value);
823 g_value_unset (&value);
825 return GTK_WIDGET (cellview);
829 * gtk_cell_view_new_with_pixbuf:
830 * @pixbuf: the image to display in the cell view
832 * Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf
833 * to it, and makes its show @pixbuf.
835 * Return value: A newly created #GtkCellView widget.
840 gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf)
842 GtkCellView *cellview;
843 GtkCellRenderer *renderer;
844 GValue value = {0, };
846 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
848 renderer = gtk_cell_renderer_pixbuf_new ();
849 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
852 g_value_init (&value, GDK_TYPE_PIXBUF);
853 g_value_set_object (&value, pixbuf);
854 gtk_cell_view_set_value (cellview, renderer, "pixbuf", &value);
855 g_value_unset (&value);
857 return GTK_WIDGET (cellview);
861 * gtk_cell_view_set_value:
862 * @cell_view: a #GtkCellView widget
863 * @renderer: one of the renderers of @cell_view
864 * @property: the name of the property of @renderer to set
865 * @value: the new value to set the property to
867 * Sets a property of a cell renderer of @cell_view, and
868 * makes sure the display of @cell_view is updated.
873 gtk_cell_view_set_value (GtkCellView *cell_view,
874 GtkCellRenderer *renderer,
878 g_object_set_property (G_OBJECT (renderer), property, value);
880 /* force resize and redraw */
881 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
882 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
886 * gtk_cell_view_set_model:
887 * @cell_view: a #GtkCellView
888 * @model: (allow-none): a #GtkTreeModel
890 * Sets the model for @cell_view. If @cell_view already has a model
891 * set, it will remove it before setting the new model. If @model is
892 * %NULL, then it will unset the old model.
897 gtk_cell_view_set_model (GtkCellView *cell_view,
900 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
901 g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model));
903 if (cell_view->priv->model)
905 if (cell_view->priv->displayed_row)
906 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
907 cell_view->priv->displayed_row = NULL;
909 g_object_unref (cell_view->priv->model);
910 cell_view->priv->model = NULL;
913 cell_view->priv->model = model;
915 if (cell_view->priv->model)
916 g_object_ref (cell_view->priv->model);
920 * gtk_cell_view_get_model:
921 * @cell_view: a #GtkCellView
923 * Returns the model for @cell_view. If no model is used %NULL is
926 * Returns: (transfer none): a #GtkTreeModel used or %NULL
931 gtk_cell_view_get_model (GtkCellView *cell_view)
933 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
935 return cell_view->priv->model;
939 * gtk_cell_view_set_displayed_row:
940 * @cell_view: a #GtkCellView
941 * @path: (allow-none): a #GtkTreePath or %NULL to unset.
943 * Sets the row of the model that is currently displayed
944 * by the #GtkCellView. If the path is unset, then the
945 * contents of the cellview "stick" at their last value;
946 * this is not normally a desired result, but may be
947 * a needed intermediate state if say, the model for
948 * the #GtkCellView becomes temporarily empty.
953 gtk_cell_view_set_displayed_row (GtkCellView *cell_view,
956 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
957 g_return_if_fail (GTK_IS_TREE_MODEL (cell_view->priv->model));
959 if (cell_view->priv->displayed_row)
960 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
964 cell_view->priv->displayed_row =
965 gtk_tree_row_reference_new (cell_view->priv->model, path);
968 cell_view->priv->displayed_row = NULL;
970 /* force resize and redraw */
971 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
972 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
976 * gtk_cell_view_get_displayed_row:
977 * @cell_view: a #GtkCellView
979 * Returns a #GtkTreePath referring to the currently
980 * displayed row. If no row is currently displayed,
983 * Returns: the currently displayed row or %NULL
988 gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
990 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
992 if (!cell_view->priv->displayed_row)
995 return gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
999 * gtk_cell_view_get_size_of_row:
1000 * @cell_view: a #GtkCellView
1001 * @path: a #GtkTreePath
1002 * @requisition: return location for the size
1004 * Sets @requisition to the size needed by @cell_view to display
1005 * the model row pointed to by @path.
1007 * Return value: %TRUE
1011 * Deprecated: 3.0: Use gtk_cell_view_get_desired_width_of_row() and
1012 * gtk_cell_view_get_desired_height_for_width_of_row() instead.
1015 gtk_cell_view_get_size_of_row (GtkCellView *cell_view,
1017 GtkRequisition *requisition)
1021 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), FALSE);
1022 g_return_val_if_fail (path != NULL, FALSE);
1024 /* Return the minimum height for the minimum width */
1025 gtk_cell_view_get_desired_width_of_row (cell_view, path, &req.width, NULL);
1026 gtk_cell_view_get_desired_height_for_width_of_row (cell_view, path, req.width, &req.height, NULL);
1036 * gtk_cell_view_get_desired_width_of_row:
1037 * @cell_view: a #GtkCellView
1038 * @path: a #GtkTreePath
1039 * @minimum_size: location to store the minimum size
1040 * @natural_size: location to store the natural size
1042 * Sets @minimum_size and @natural_size to the width desired by @cell_view
1043 * to display the model row pointed to by @path.
1048 gtk_cell_view_get_desired_width_of_row (GtkCellView *cell_view,
1053 GtkTreeRowReference *tmp;
1055 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1056 g_return_if_fail (path != NULL);
1057 g_return_if_fail (minimum_size != NULL || natural_size != NULL);
1059 tmp = cell_view->priv->displayed_row;
1060 cell_view->priv->displayed_row =
1061 gtk_tree_row_reference_new (cell_view->priv->model, path);
1063 gtk_cell_view_get_width (GTK_SIZE_REQUEST (cell_view), minimum_size, natural_size);
1065 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1066 cell_view->priv->displayed_row = tmp;
1068 /* Restore active size (this will restore the cellrenderer info->width/requested_width's) */
1069 gtk_cell_view_get_width (GTK_SIZE_REQUEST (cell_view), NULL, NULL);
1074 * gtk_cell_view_get_desired_height_for_width_of_row:
1075 * @cell_view: a #GtkCellView
1076 * @path: a #GtkTreePath
1077 * @avail_size: available width
1078 * @minimum_size: location to store the minimum height
1079 * @natural_size: location to store the natural height
1081 * Sets @minimum_size and @natural_size to the height desired by @cell_view
1082 * if it were allocated a width of @avail_size to display the model row
1083 * pointed to by @path.
1088 gtk_cell_view_get_desired_height_for_width_of_row (GtkCellView *cell_view,
1094 GtkTreeRowReference *tmp;
1096 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1097 g_return_if_fail (path != NULL);
1098 g_return_if_fail (minimum_size != NULL || natural_size != NULL);
1100 tmp = cell_view->priv->displayed_row;
1101 cell_view->priv->displayed_row =
1102 gtk_tree_row_reference_new (cell_view->priv->model, path);
1104 /* Then get the collective height_for_width based on the cached values */
1105 gtk_cell_view_get_height_for_width (GTK_SIZE_REQUEST (cell_view), avail_size, minimum_size, natural_size);
1107 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1108 cell_view->priv->displayed_row = tmp;
1110 /* Restore active size (this will restore the cellrenderer info->width/requested_width's) */
1111 gtk_cell_view_get_width (GTK_SIZE_REQUEST (cell_view), NULL, NULL);
1115 * gtk_cell_view_set_background_color:
1116 * @cell_view: a #GtkCellView
1117 * @color: the new background color
1119 * Sets the background color of @view.
1124 gtk_cell_view_set_background_color (GtkCellView *cell_view,
1125 const GdkColor *color)
1127 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1131 if (!cell_view->priv->background_set)
1133 cell_view->priv->background_set = TRUE;
1134 g_object_notify (G_OBJECT (cell_view), "background-set");
1137 cell_view->priv->background = *color;
1141 if (cell_view->priv->background_set)
1143 cell_view->priv->background_set = FALSE;
1144 g_object_notify (G_OBJECT (cell_view), "background-set");
1148 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1152 gtk_cell_view_cell_layout_get_cells (GtkCellLayout *layout)
1154 GtkCellView *cell_view = GTK_CELL_VIEW (layout);
1155 GList *retval = NULL, *list;
1157 g_return_val_if_fail (cell_view != NULL, NULL);
1159 gtk_cell_view_set_cell_data (cell_view);
1161 for (list = cell_view->priv->cell_list; list; list = list->next)
1163 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1165 retval = g_list_prepend (retval, info->cell);
1168 return g_list_reverse (retval);
1172 gtk_cell_view_buildable_custom_tag_start (GtkBuildable *buildable,
1173 GtkBuilder *builder,
1175 const gchar *tagname,
1176 GMarkupParser *parser,
1179 if (parent_buildable_iface->custom_tag_start &&
1180 parent_buildable_iface->custom_tag_start (buildable, builder, child,
1181 tagname, parser, data))
1184 return _gtk_cell_layout_buildable_custom_tag_start (buildable, builder, child,
1185 tagname, parser, data);
1189 gtk_cell_view_buildable_custom_tag_end (GtkBuildable *buildable,
1190 GtkBuilder *builder,
1192 const gchar *tagname,
1195 if (strcmp (tagname, "attributes") == 0)
1196 _gtk_cell_layout_buildable_custom_tag_end (buildable, builder, child, tagname,
1198 else if (parent_buildable_iface->custom_tag_end)
1199 parent_buildable_iface->custom_tag_end (buildable, builder, child, tagname,
1204 gtk_cell_view_size_request_init (GtkSizeRequestIface *iface)
1206 iface->get_width = gtk_cell_view_get_width;
1207 iface->get_height = gtk_cell_view_get_height;
1208 iface->get_width_for_height = gtk_cell_view_get_width_for_height;
1209 iface->get_height_for_width = gtk_cell_view_get_height_for_width;
1213 gtk_cell_view_get_width (GtkSizeRequest *widget,
1218 gint cell_min, cell_nat;
1219 gboolean first_cell = TRUE;
1220 GtkCellView *cellview = GTK_CELL_VIEW (widget);
1221 gint minimum, natural;
1223 minimum = natural = 0;
1225 if (cellview->priv->displayed_row)
1226 gtk_cell_view_set_cell_data (cellview);
1228 for (list = cellview->priv->cell_list; list; list = list->next)
1230 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1232 if (gtk_cell_renderer_get_visible (info->cell))
1237 minimum += cellview->priv->spacing;
1238 natural += cellview->priv->spacing;
1241 gtk_cell_size_request_get_width (GTK_CELL_SIZE_REQUEST (info->cell),
1242 GTK_WIDGET (cellview), &cell_min, &cell_nat);
1244 info->requested_width = cell_min;
1245 info->natural_width = cell_nat;
1247 minimum += info->requested_width;
1248 natural += info->natural_width;
1255 *minimum_size = minimum;
1258 *natural_size = natural;
1262 gtk_cell_view_get_height (GtkSizeRequest *widget,
1268 /* CellViews only need to respond to height-for-width mode (cellview is pretty much
1269 * an implementation detail of GtkComboBox) */
1270 gtk_cell_view_get_width (widget, &minimum_width, NULL);
1271 gtk_cell_view_get_height_for_width (widget, minimum_width, minimum_size, natural_size);
1275 gtk_cell_view_get_width_for_height (GtkSizeRequest *widget,
1280 /* CellViews only need to respond to height-for-width mode (cellview is pretty much
1281 * an implementation detail of GtkComboBox) */
1282 gtk_cell_view_get_width (widget, minimum_size, natural_size);
1286 gtk_cell_view_get_height_for_width (GtkSizeRequest *widget,
1291 GtkCellView *cellview = GTK_CELL_VIEW (widget);
1293 GtkRequestedSize *sizes;
1295 gint minimum, natural, avail_size;
1296 gboolean first_cell = TRUE;
1297 gint n_expand_cells = 0;
1298 gint extra_per_cell, extra_extra, i;
1300 minimum = natural = 0;
1301 avail_size = for_size;
1303 array = g_array_new (0, TRUE, sizeof (GtkRequestedSize));
1305 if (cellview->priv->displayed_row)
1306 gtk_cell_view_set_cell_data (cellview);
1308 /* First allocate the right width to all cells */
1309 for (list = cellview->priv->cell_list; list; list = list->next)
1311 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1313 if (gtk_cell_renderer_get_visible (info->cell))
1315 GtkRequestedSize requested;
1317 gtk_cell_size_request_get_width (GTK_CELL_SIZE_REQUEST (info->cell),
1318 GTK_WIDGET (cellview),
1319 &requested.minimum_size,
1320 &requested.natural_size);
1322 requested.data = info;
1323 g_array_append_val (array, requested);
1325 avail_size -= requested.minimum_size;
1328 avail_size -= cellview->priv->spacing;
1337 sizes = (GtkRequestedSize *)array->data;
1338 avail_size = gtk_distribute_natural_allocation (MAX (0, avail_size), array->len, sizes);
1340 /* Deal with any expand space... */
1341 if (n_expand_cells > 0)
1343 extra_per_cell = avail_size / n_expand_cells;
1344 extra_extra = avail_size % n_expand_cells;
1347 /* Everything just left-aligned if no cells expand */
1348 extra_per_cell = extra_extra = 0;
1350 /* Now get the height for the real width of each cell */
1351 for (i = 0, list = cellview->priv->cell_list; list; list = list->next)
1353 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1354 gint cell_minimum, cell_natural;
1356 if (gtk_cell_renderer_get_visible (info->cell))
1358 gint cell_width = sizes[i].minimum_size;
1360 g_assert (sizes[i].data == info);
1364 cell_width += extra_per_cell;
1372 /* Get the height for the real width of this cell */
1373 gtk_cell_size_request_get_height_for_width (GTK_CELL_SIZE_REQUEST (info->cell),
1374 GTK_WIDGET (widget),
1375 cell_width, &cell_minimum, &cell_natural);
1377 minimum = MAX (minimum, cell_minimum);
1378 natural = MAX (natural, cell_natural);
1380 /* increment sizes[] index for visible cells */
1385 g_array_free (array, TRUE);
1388 *minimum_size = minimum;
1390 *natural_size = natural;