]> Pileus Git - ~andy/gtk/blob - gtk/gtkcellview.c
efdda51009d483d6a4d70fa413be7c7d06a99258
[~andy/gtk] / gtk / gtkcellview.c
1 /* gtkellview.c
2  * Copyright (C) 2002, 2003  Kristian Rietveld <kris@gtk.org>
3  *
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.
8  *
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.
13  *
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.
18  */
19
20 #include <config.h>
21 #include "gtkcellview.h"
22 #include "gtkcelllayout.h"
23 #include "gtkintl.h"
24 #include "gtksignal.h"
25 #include "gtkcellrenderertext.h"
26 #include "gtkcellrendererpixbuf.h"
27 #include "gtkprivate.h"
28 #include <gobject/gmarshal.h>
29 #include "gtkalias.h"
30
31 typedef struct _GtkCellViewCellInfo GtkCellViewCellInfo;
32 struct _GtkCellViewCellInfo
33 {
34   GtkCellRenderer *cell;
35
36   gint requested_width;
37   gint real_width;
38   guint expand : 1;
39   guint pack : 1;
40
41   GSList *attributes;
42
43   GtkCellLayoutDataFunc func;
44   gpointer func_data;
45   GDestroyNotify destroy;
46 };
47
48 struct _GtkCellViewPrivate
49 {
50   GtkTreeModel *model;
51   GtkTreeRowReference *displayed_row;
52   GList *cell_list;
53   gint spacing;
54
55   GdkColor background;
56   gboolean background_set;
57 };
58
59
60 static void        gtk_cell_view_class_init               (GtkCellViewClass *klass);
61 static void        gtk_cell_view_cell_layout_init         (GtkCellLayoutIface *iface);
62 static void        gtk_cell_view_get_property             (GObject           *object,
63                                                            guint             param_id,
64                                                            GValue           *value,
65                                                            GParamSpec       *pspec);
66 static void        gtk_cell_view_set_property             (GObject          *object,
67                                                            guint             param_id,
68                                                            const GValue     *value,
69                                                            GParamSpec       *pspec);
70 static void        gtk_cell_view_init                     (GtkCellView      *cellview);
71 static void        gtk_cell_view_finalize                 (GObject          *object);
72 static void        gtk_cell_view_style_set                (GtkWidget        *widget,
73                                                            GtkStyle         *previous_style);
74 static void        gtk_cell_view_size_request             (GtkWidget        *widget,
75                                                            GtkRequisition   *requisition);
76 static void        gtk_cell_view_size_allocate            (GtkWidget        *widget,
77                                                            GtkAllocation    *allocation);
78 static gboolean    gtk_cell_view_expose                   (GtkWidget        *widget,
79                                                            GdkEventExpose   *event);
80 static void        gtk_cell_view_set_value                (GtkCellView     *cell_view,
81                                                            GtkCellRenderer *renderer,
82                                                            gchar           *property,
83                                                            GValue          *value);
84 static GtkCellViewCellInfo *gtk_cell_view_get_cell_info   (GtkCellView      *cellview,
85                                                            GtkCellRenderer  *renderer);
86 static void        gtk_cell_view_set_cell_data            (GtkCellView      *cell_view);
87
88
89 static void        gtk_cell_view_cell_layout_pack_start        (GtkCellLayout         *layout,
90                                                                 GtkCellRenderer       *renderer,
91                                                                 gboolean               expand);
92 static void        gtk_cell_view_cell_layout_pack_end          (GtkCellLayout         *layout,
93                                                                 GtkCellRenderer       *renderer,
94                                                                 gboolean               expand);
95 static void        gtk_cell_view_cell_layout_add_attribute     (GtkCellLayout         *layout,
96                                                                 GtkCellRenderer       *renderer,
97                                                                 const gchar           *attribute,
98                                                                 gint                   column);
99 static void       gtk_cell_view_cell_layout_clear              (GtkCellLayout         *layout);
100 static void       gtk_cell_view_cell_layout_clear_attributes   (GtkCellLayout         *layout,
101                                                                 GtkCellRenderer       *renderer);
102 static void       gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout         *layout,
103                                                                 GtkCellRenderer       *cell,
104                                                                 GtkCellLayoutDataFunc  func,
105                                                                 gpointer               func_data,
106                                                                 GDestroyNotify         destroy);
107 static void       gtk_cell_view_cell_layout_reorder            (GtkCellLayout         *layout,
108                                                                 GtkCellRenderer       *cell,
109                                                                 gint                   position);
110
111
112 #define GTK_CELL_VIEW_GET_PRIVATE(obj)    (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_CELL_VIEW, GtkCellViewPrivate))
113
114 enum
115 {
116   PROP_0,
117   PROP_BACKGROUND,
118   PROP_BACKGROUND_GDK,
119   PROP_BACKGROUND_SET
120 };
121
122 static GtkObjectClass *parent_class = NULL;
123
124
125 GType
126 gtk_cell_view_get_type (void)
127 {
128   static GType cell_view_type = 0;
129
130   if (!cell_view_type)
131     {
132       static const GTypeInfo cell_view_info =
133         {
134           sizeof (GtkCellViewClass),
135           NULL, /* base_init */
136           NULL, /* base_finalize */
137           (GClassInitFunc) gtk_cell_view_class_init,
138           NULL, /* class_finalize */
139           NULL, /* class_data */
140           sizeof (GtkCellView),
141           0,
142           (GInstanceInitFunc) gtk_cell_view_init
143         };
144
145       static const GInterfaceInfo cell_layout_info =
146        {
147          (GInterfaceInitFunc) gtk_cell_view_cell_layout_init,
148          NULL,
149          NULL
150        };
151
152       cell_view_type = g_type_register_static (GTK_TYPE_WIDGET, "GtkCellView",
153                                                &cell_view_info, 0);
154
155       g_type_add_interface_static (cell_view_type, GTK_TYPE_CELL_LAYOUT,
156                                    &cell_layout_info);
157     }
158
159   return cell_view_type;
160 }
161
162 static void
163 gtk_cell_view_class_init (GtkCellViewClass *klass)
164 {
165   GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
166   GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
167
168   parent_class = g_type_class_peek_parent (klass);
169
170   gobject_class->get_property = gtk_cell_view_get_property;
171   gobject_class->set_property = gtk_cell_view_set_property;
172   gobject_class->finalize = gtk_cell_view_finalize;
173
174   widget_class->expose_event = gtk_cell_view_expose;
175   widget_class->size_allocate = gtk_cell_view_size_allocate;
176   widget_class->size_request = gtk_cell_view_size_request;
177   widget_class->style_set = gtk_cell_view_style_set;
178
179   /* properties */
180   g_object_class_install_property (gobject_class,
181                                    PROP_BACKGROUND,
182                                    g_param_spec_string ("background",
183                                                         P_("Background color name"),
184                                                         P_("Background color as a string"),
185                                                         NULL,
186                                                         GTK_PARAM_WRITABLE));
187   g_object_class_install_property (gobject_class,
188                                    PROP_BACKGROUND_GDK,
189                                    g_param_spec_boxed ("background-gdk",
190                                                       P_("Background color"),
191                                                       P_("Background color as a GdkColor"),
192                                                       GDK_TYPE_COLOR,
193                                                       GTK_PARAM_READWRITE));
194
195 #define ADD_SET_PROP(propname, propval, nick, blurb) g_object_class_install_property (gobject_class, propval, g_param_spec_boolean (propname, nick, blurb, FALSE, GTK_PARAM_READWRITE))
196
197   ADD_SET_PROP ("background-set", PROP_BACKGROUND_SET,
198                 P_("Background set"),
199                 P_("Whether this tag affects the background color"));
200
201   g_type_class_add_private (gobject_class, sizeof (GtkCellViewPrivate));
202 }
203
204 static void
205 gtk_cell_view_cell_layout_init (GtkCellLayoutIface *iface)
206 {
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 }
215
216 static void
217 gtk_cell_view_get_property (GObject    *object,
218                             guint       param_id,
219                             GValue     *value,
220                             GParamSpec *pspec)
221 {
222   GtkCellView *view = GTK_CELL_VIEW (object);
223
224   switch (param_id)
225     {
226       case PROP_BACKGROUND_GDK:
227         {
228           GdkColor color;
229
230           color = view->priv->background;
231
232           g_value_set_boxed (value, &color);
233         }
234         break;
235       case PROP_BACKGROUND_SET:
236         g_value_set_boolean (value, view->priv->background_set);
237         break;
238       default:
239         G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
240         break;
241     }
242 }
243
244 static void
245 gtk_cell_view_set_property (GObject      *object,
246                             guint         param_id,
247                             const GValue *value,
248                             GParamSpec   *pspec)
249 {
250   GtkCellView *view = GTK_CELL_VIEW (object);
251
252   switch (param_id)
253     {
254       case PROP_BACKGROUND:
255         {
256           GdkColor color;
257
258           if (!g_value_get_string (value))
259             gtk_cell_view_set_background_color (view, NULL);
260           else if (gdk_color_parse (g_value_get_string (value), &color))
261             gtk_cell_view_set_background_color (view, &color);
262           else
263             g_warning ("Don't know color `%s'", g_value_get_string (value));
264
265           g_object_notify (object, "background_gdk");
266         }
267         break;
268       case PROP_BACKGROUND_GDK:
269         gtk_cell_view_set_background_color (view, g_value_get_boxed (value));
270         break;
271       case PROP_BACKGROUND_SET:
272         view->priv->background_set = g_value_get_boolean (value);
273         break;
274       default:
275         G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
276         break;
277     }
278 }
279
280 static void
281 gtk_cell_view_init (GtkCellView *cellview)
282 {
283   GTK_WIDGET_SET_FLAGS (cellview, GTK_NO_WINDOW);
284
285   cellview->priv = GTK_CELL_VIEW_GET_PRIVATE (cellview);
286 }
287
288 static void
289 gtk_cell_view_style_set (GtkWidget *widget,
290                          GtkStyle  *previous_style)
291 {
292   if (previous_style && GTK_WIDGET_REALIZED (widget))
293     gdk_window_set_background (widget->window,
294                                &widget->style->base[GTK_WIDGET_STATE (widget)]);
295 }
296
297 static void
298 gtk_cell_view_finalize (GObject *object)
299 {
300   GtkCellView *cellview = GTK_CELL_VIEW (object);
301
302   gtk_cell_view_cell_layout_clear (GTK_CELL_LAYOUT (cellview));
303
304   if (cellview->priv->model)
305      g_object_unref (cellview->priv->model);
306
307   if (cellview->priv->displayed_row)
308      gtk_tree_row_reference_free (cellview->priv->displayed_row);
309
310   (* G_OBJECT_CLASS (parent_class)->finalize) (object);
311 }
312
313 static void
314 gtk_cell_view_size_request (GtkWidget      *widget,
315                             GtkRequisition *requisition)
316 {
317   GList *i;
318   gboolean first_cell = TRUE;
319   GtkCellView *cellview;
320
321   cellview = GTK_CELL_VIEW (widget);
322
323   requisition->width = 0;
324   requisition->height = 0;
325
326   if (cellview->priv->displayed_row)
327     gtk_cell_view_set_cell_data (cellview);
328
329   for (i = cellview->priv->cell_list; i; i = i->next)
330     {
331       gint width, height;
332       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
333
334       if (!info->cell->visible)
335         continue;
336
337       if (!first_cell)
338         requisition->width += cellview->priv->spacing;
339
340       gtk_cell_renderer_get_size (info->cell, widget, NULL, NULL, NULL,
341                                   &width, &height);
342
343       info->requested_width = width;
344       requisition->width += width;
345       requisition->height = MAX (requisition->height, height);
346
347       first_cell = FALSE;
348     }
349 }
350
351 static void
352 gtk_cell_view_size_allocate (GtkWidget     *widget,
353                              GtkAllocation *allocation)
354 {
355   GList *i;
356   gint expand_cell_count = 0;
357   gint full_requested_width = 0;
358   gint extra_space;
359   GtkCellView *cellview;
360
361   widget->allocation = *allocation;
362
363   cellview = GTK_CELL_VIEW (widget);
364
365   /* checking how much extra space we have */
366   for (i = cellview->priv->cell_list; i; i = i->next)
367     {
368       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
369
370       if (!info->cell->visible)
371         continue;
372
373       if (info->expand)
374         expand_cell_count++;
375
376       full_requested_width += info->requested_width;
377     }
378
379   extra_space = widget->allocation.width - full_requested_width;
380   if (extra_space < 0)
381     extra_space = 0;
382   else if (extra_space > 0 && expand_cell_count > 0)
383     extra_space /= expand_cell_count;
384
385   /* iterate list for PACK_START cells */
386   for (i = cellview->priv->cell_list; i; i = i->next)
387     {
388       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
389
390       if (info->pack == GTK_PACK_END)
391         continue;
392
393       if (!info->cell->visible)
394         continue;
395
396       info->real_width = info->requested_width + (info->expand?extra_space:0);
397     }
398
399   /* iterate list for PACK_END cells */
400   for (i = cellview->priv->cell_list; i; i = i->next)
401     {
402       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
403
404       if (info->pack == GTK_PACK_START)
405         continue;
406
407       if (!info->cell->visible)
408         continue;
409
410       info->real_width = info->requested_width + (info->expand?extra_space:0);
411     }
412 }
413
414 static gboolean
415 gtk_cell_view_expose (GtkWidget      *widget,
416                       GdkEventExpose *event)
417 {
418   GList *i;
419   GtkCellView *cellview;
420   GdkRectangle area;
421   GtkCellRendererState state;
422   gboolean rtl = (gtk_widget_get_direction(widget) == GTK_TEXT_DIR_RTL);
423
424   cellview = GTK_CELL_VIEW (widget);
425
426   if (! GTK_WIDGET_DRAWABLE (widget))
427     return FALSE;
428
429   /* "blank" background */
430   if (cellview->priv->background_set)
431     {
432       GdkGC *gc;
433
434       gc = gdk_gc_new (GTK_WIDGET (cellview)->window);
435       gdk_gc_set_rgb_fg_color (gc, &cellview->priv->background);
436
437       gdk_draw_rectangle (GTK_WIDGET (cellview)->window,
438                           gc,
439                           TRUE,
440
441                           /*0, 0,*/
442                           widget->allocation.x,
443                           widget->allocation.y,
444
445                           widget->allocation.width,
446                           widget->allocation.height);
447
448       g_object_unref (gc);
449     }
450
451   /* set cell data (if available) */
452   if (cellview->priv->displayed_row)
453     gtk_cell_view_set_cell_data (cellview);
454   else if (cellview->priv->model)
455     return FALSE;
456
457   /* render cells */
458   area = widget->allocation;
459
460   /* we draw on our very own window, initialize x and y to zero */
461   area.x = widget->allocation.x + (rtl ? widget->allocation.width : 0); 
462   area.y = widget->allocation.y;
463
464   if (GTK_WIDGET_STATE (widget) == GTK_STATE_PRELIGHT)
465     state = GTK_CELL_RENDERER_PRELIT;
466   else
467     state = 0;
468       
469   /* PACK_START */
470   for (i = cellview->priv->cell_list; i; i = i->next)
471     {
472       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
473
474       if (info->pack == GTK_PACK_END)
475         continue;
476
477       if (!info->cell->visible)
478         continue;
479
480       area.width = info->real_width;
481       if (rtl)                                             
482          area.x -= area.width;
483
484       gtk_cell_renderer_render (info->cell,
485                                 event->window,
486                                 widget,
487                                 /* FIXME! */
488                                 &area, &area, &event->area, state);
489
490       if (!rtl)                                           
491          area.x += info->real_width;
492     }
493
494    area.x = rtl ? widget->allocation.x : (widget->allocation.x + widget->allocation.width);  
495
496   /* PACK_END */
497   for (i = cellview->priv->cell_list; i; i = i->next)
498     {
499       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
500
501       if (info->pack == GTK_PACK_START)
502         continue;
503
504       if (!info->cell->visible)
505         continue;
506
507       area.width = info->real_width;
508       if (!rtl)
509          area.x -= area.width;   
510
511       gtk_cell_renderer_render (info->cell,
512                                 widget->window,
513                                 widget,
514                                 /* FIXME ! */
515                                 &area, &area, &event->area, state);
516       if (rtl)
517          area.x += info->real_width;
518     }
519
520   return FALSE;
521 }
522
523 static GtkCellViewCellInfo *
524 gtk_cell_view_get_cell_info (GtkCellView     *cellview,
525                              GtkCellRenderer *renderer)
526 {
527   GList *i;
528
529   for (i = cellview->priv->cell_list; i; i = i->next)
530     {
531       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
532
533       if (info->cell == renderer)
534         return info;
535     }
536
537   return NULL;
538 }
539
540 static void
541 gtk_cell_view_set_cell_data (GtkCellView *cell_view)
542 {
543   GList *i;
544   GtkTreeIter iter;
545   GtkTreePath *path;
546
547   g_return_if_fail (cell_view->priv->displayed_row != NULL);
548
549   path = gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
550   if (!path)
551     return;
552
553   gtk_tree_model_get_iter (cell_view->priv->model, &iter, path);
554   gtk_tree_path_free (path);
555
556   for (i = cell_view->priv->cell_list; i; i = i->next)
557     {
558       GSList *j;
559       GtkCellViewCellInfo *info = i->data;
560
561       g_object_freeze_notify (G_OBJECT (info->cell));
562
563       for (j = info->attributes; j && j->next; j = j->next->next)
564         {
565           gchar *property = j->data;
566           gint column = GPOINTER_TO_INT (j->next->data);
567           GValue value = {0, };
568
569           gtk_tree_model_get_value (cell_view->priv->model, &iter,
570                                     column, &value);
571           g_object_set_property (G_OBJECT (info->cell),
572                                  property, &value);
573           g_value_unset (&value);
574         }
575
576       if (info->func)
577         (* info->func) (GTK_CELL_LAYOUT (cell_view),
578                         info->cell,
579                         cell_view->priv->model,
580                         &iter,
581                         info->func_data);
582
583       g_object_thaw_notify (G_OBJECT (info->cell));
584     }
585 }
586
587 /* GtkCellLayout implementation */
588 static void
589 gtk_cell_view_cell_layout_pack_start (GtkCellLayout   *layout,
590                                       GtkCellRenderer *renderer,
591                                       gboolean         expand)
592 {
593   GtkCellViewCellInfo *info;
594   GtkCellView *cellview = GTK_CELL_VIEW (layout);
595
596   g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
597   g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
598   g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
599
600   g_object_ref (renderer);
601   gtk_object_sink (GTK_OBJECT (renderer));
602
603   info = g_new0 (GtkCellViewCellInfo, 1);
604   info->cell = renderer;
605   info->expand = expand ? TRUE : FALSE;
606   info->pack = GTK_PACK_START;
607
608   cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
609 }
610
611 static void
612 gtk_cell_view_cell_layout_pack_end (GtkCellLayout   *layout,
613                                     GtkCellRenderer *renderer,
614                                     gboolean         expand)
615 {
616   GtkCellViewCellInfo *info;
617   GtkCellView *cellview = GTK_CELL_VIEW (layout);
618
619   g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
620   g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
621   g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
622
623   g_object_ref (renderer);
624   gtk_object_sink (GTK_OBJECT (renderer));
625
626   info = g_new0 (GtkCellViewCellInfo, 1);
627   info->cell = renderer;
628   info->expand = expand ? TRUE : FALSE;
629   info->pack = GTK_PACK_END;
630
631   cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
632 }
633
634 static void
635 gtk_cell_view_cell_layout_add_attribute (GtkCellLayout   *layout,
636                                          GtkCellRenderer *renderer,
637                                          const gchar     *attribute,
638                                          gint             column)
639 {
640   GtkCellViewCellInfo *info;
641   GtkCellView *cellview = GTK_CELL_VIEW (layout);
642
643   g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
644   info = gtk_cell_view_get_cell_info (cellview, renderer);
645   g_return_if_fail (info != NULL);
646
647   info->attributes = g_slist_prepend (info->attributes,
648                                       GINT_TO_POINTER (column));
649   info->attributes = g_slist_prepend (info->attributes,
650                                       g_strdup (attribute));
651 }
652
653 static void
654 gtk_cell_view_cell_layout_clear (GtkCellLayout *layout)
655 {
656   GtkCellView *cellview = GTK_CELL_VIEW (layout);
657
658   g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
659
660   while (cellview->priv->cell_list)
661     {
662       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)cellview->priv->cell_list->data;
663
664       gtk_cell_view_cell_layout_clear_attributes (layout, info->cell);
665       g_object_unref (info->cell);
666       g_free (info);
667       cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list, 
668                                                       cellview->priv->cell_list);
669     }
670 }
671
672 static void
673 gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout         *layout,
674                                               GtkCellRenderer       *cell,
675                                               GtkCellLayoutDataFunc  func,
676                                               gpointer               func_data,
677                                               GDestroyNotify         destroy)
678 {
679   GtkCellView *cellview = GTK_CELL_VIEW (layout);
680   GtkCellViewCellInfo *info;
681
682   g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
683
684   info = gtk_cell_view_get_cell_info (cellview, cell);
685   g_return_if_fail (info != NULL);
686
687   if (info->destroy)
688     {
689       GDestroyNotify d = info->destroy;
690
691       info->destroy = NULL;
692       d (info->func_data);
693     }
694
695   info->func = func;
696   info->func_data = func_data;
697   info->destroy = destroy;
698 }
699
700 static void
701 gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout   *layout,
702                                             GtkCellRenderer *renderer)
703 {
704   GtkCellViewCellInfo *info;
705   GtkCellView *cellview = GTK_CELL_VIEW (layout);
706   GSList *list;
707
708   g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
709   g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
710
711   info = gtk_cell_view_get_cell_info (cellview, renderer);
712   if (info != NULL)
713     {
714       list = info->attributes;
715       while (list && list->next)
716         {
717           g_free (list->data);
718           list = list->next->next;
719         }
720       
721       g_slist_free (info->attributes);
722       info->attributes = NULL;
723     }
724 }
725
726 static void
727 gtk_cell_view_cell_layout_reorder (GtkCellLayout   *layout,
728                                    GtkCellRenderer *cell,
729                                    gint             position)
730 {
731   GList *link;
732   GtkCellViewCellInfo *info;
733   GtkCellView *cellview = GTK_CELL_VIEW (layout);
734
735   g_return_if_fail (GTK_IS_CELL_VIEW (cellview));
736   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
737
738   info = gtk_cell_view_get_cell_info (cellview, cell);
739
740   g_return_if_fail (info != NULL);
741   g_return_if_fail (position >= 0);
742
743   link = g_list_find (cellview->priv->cell_list, info);
744
745   g_return_if_fail (link != NULL);
746
747   cellview->priv->cell_list = g_list_remove_link (cellview->priv->cell_list,
748                                                   link);
749   cellview->priv->cell_list = g_list_insert (cellview->priv->cell_list,
750                                              info, position);
751
752   gtk_widget_queue_draw (GTK_WIDGET (cellview));
753 }
754
755 /**
756  * gtk_cell_view_new:
757  *
758  * Creates a new #GtkCellView widget.
759  *
760  * Return value: A newly created #GtkCellView widget.
761  *
762  * Since: 2.6
763  */
764 GtkWidget *
765 gtk_cell_view_new (void)
766 {
767   GtkCellView *cellview;
768
769   cellview = g_object_new (gtk_cell_view_get_type (), NULL);
770
771   return GTK_WIDGET (cellview);
772 }
773
774 /**
775  * gtk_cell_view_new_with_text:
776  * @text: the text to display in the cell view
777  *
778  * Creates a new #GtkCellView widget, adds a #GtkCellRendererText 
779  * to it, and makes its show @text.
780  *
781  * Return value: A newly created #GtkCellView widget.
782  *
783  * Since: 2.6
784  */
785 GtkWidget *
786 gtk_cell_view_new_with_text (const gchar *text)
787 {
788   GtkCellView *cellview;
789   GtkCellRenderer *renderer;
790   GValue value = {0, };
791
792   cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
793
794   renderer = gtk_cell_renderer_text_new ();
795   gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
796                                         renderer, TRUE);
797
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);
802
803   return GTK_WIDGET (cellview);
804 }
805
806 /**
807  * gtk_cell_view_new_with_markup:
808  * @markup: the text to display in the cell view
809  *
810  * Creates a new #GtkCellView widget, adds a #GtkCellRendererText 
811  * to it, and makes its show @markup. The text can text can be
812  * marked up with the <link linkend="PangoMarkupFormat">Pango text 
813  * markup language</link>.
814  *
815  * Return value: A newly created #GtkCellView widget.
816  *
817  * Since: 2.6
818  */
819 GtkWidget *
820 gtk_cell_view_new_with_markup (const gchar *markup)
821 {
822   GtkCellView *cellview;
823   GtkCellRenderer *renderer;
824   GValue value = {0, };
825
826   cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
827
828   renderer = gtk_cell_renderer_text_new ();
829   gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
830                                         renderer, TRUE);
831
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);
836
837   return GTK_WIDGET (cellview);
838 }
839
840 /**
841  * gtk_cell_view_new_with_pixbuf:
842  * @pixbuf: the image to display in the cell view
843  *
844  * Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf 
845  * to it, and makes its show @pixbuf. 
846  *
847  * Return value: A newly created #GtkCellView widget.
848  *
849  * Since: 2.6
850  */
851 GtkWidget *
852 gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf)
853 {
854   GtkCellView *cellview;
855   GtkCellRenderer *renderer;
856   GValue value = {0, };
857
858   cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
859
860   renderer = gtk_cell_renderer_pixbuf_new ();
861   gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
862                                         renderer, TRUE);
863
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);
868
869   return GTK_WIDGET (cellview);
870 }
871
872 /**
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
878  * 
879  * Sets a property of a cell renderer of @cell_view, and
880  * makes sure the display of @cell_view is updated.
881  *
882  * Since: 2.6
883  */
884 static void
885 gtk_cell_view_set_value (GtkCellView     *cell_view,
886                          GtkCellRenderer *renderer,
887                          gchar           *property,
888                          GValue          *value)
889 {
890   g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
891   g_return_if_fail (GTK_IS_CELL_RENDERER (renderer));
892
893   g_object_set_property (G_OBJECT (renderer), property, value);
894
895   /* force resize and redraw */
896   gtk_widget_queue_resize (GTK_WIDGET (cell_view));
897   gtk_widget_queue_draw (GTK_WIDGET (cell_view));
898 }
899
900 /**
901  * gtk_cell_view_set_model:
902  * @cell_view: a #GtkCellView
903  * @model: a #GtkTreeModel
904  *
905  * Sets the model for @cell_view.  If @cell_view already has a model
906  * set, it will remove it before setting the new model.  If @model is 
907  * %NULL, then it will unset the old model.
908  *
909  * Since: 2.6
910  */
911 void
912 gtk_cell_view_set_model (GtkCellView  *cell_view,
913                          GtkTreeModel *model)
914 {
915   g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
916   g_return_if_fail (GTK_IS_TREE_MODEL (model));
917
918   if (cell_view->priv->model)
919     {
920       if (cell_view->priv->displayed_row)
921         gtk_tree_row_reference_free (cell_view->priv->displayed_row);
922       cell_view->priv->displayed_row = NULL;
923
924       g_object_unref (cell_view->priv->model);
925       cell_view->priv->model = NULL;
926     }
927
928   cell_view->priv->model = model;
929
930   if (cell_view->priv->model)
931     g_object_ref (cell_view->priv->model);
932 }
933
934 /**
935  * gtk_cell_view_set_displayed_row:
936  * @cell_view: a #GtkCellView
937  * @path: a #GtkTreePath or %NULL to unset.
938  * 
939  * Sets the row of the model that is currently displayed
940  * by the #GtkCellView. If the path is unset, then the
941  * contents of the cellview "stick" at their last value;
942  * this is not normally a desired result, but may be
943  * a needed intermediate state if say, the model for
944  * the #GtkCellView becomes temporarily empty.
945  *
946  * Since: 2.6
947  **/
948 void
949 gtk_cell_view_set_displayed_row (GtkCellView *cell_view,
950                                  GtkTreePath *path)
951 {
952   g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
953   g_return_if_fail (GTK_IS_TREE_MODEL (cell_view->priv->model));
954
955   if (cell_view->priv->displayed_row)
956     gtk_tree_row_reference_free (cell_view->priv->displayed_row);
957
958   if (path)
959     {
960       cell_view->priv->displayed_row =
961         gtk_tree_row_reference_new (cell_view->priv->model, path);
962     }
963   else
964     cell_view->priv->displayed_row = NULL;
965
966   /* force resize and redraw */
967   gtk_widget_queue_resize (GTK_WIDGET (cell_view));
968   gtk_widget_queue_draw (GTK_WIDGET (cell_view));
969 }
970
971 /**
972  * gtk_cell_view_get_displayed_row:
973  * @cell_view: a #GtkCellView
974  *
975  * Returns a #GtkTreePath referring to the currently 
976  * displayed row. If no row is currently displayed, 
977  * %NULL is returned.
978  *
979  * Returns: the currently displayed row or %NULL
980  *
981  * Since: 2.6
982  */
983 GtkTreePath *
984 gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
985 {
986   g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
987
988   if (!cell_view->priv->displayed_row)
989     return NULL;
990
991   return gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
992 }
993
994 /**
995  * gtk_cell_view_get_size_of_row:
996  * @cell_view: a #GtkCellView
997  * @path: a #GtkTreePath 
998  * @requisition: return location for the size 
999  *
1000  * Sets @requisition to the size needed by @cell_view to display 
1001  * the model row pointed to by @path.
1002  * 
1003  * Return value: %TRUE
1004  *
1005  * Since: 2.6
1006  */
1007 gboolean
1008 gtk_cell_view_get_size_of_row (GtkCellView    *cell_view,
1009                                GtkTreePath    *path,
1010                                GtkRequisition *requisition)
1011 {
1012   GtkTreeRowReference *tmp;
1013   GtkRequisition req;
1014
1015   g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), FALSE);
1016   g_return_val_if_fail (path != NULL, FALSE);
1017   g_return_val_if_fail (requisition != NULL, FALSE);
1018
1019   tmp = cell_view->priv->displayed_row;
1020   cell_view->priv->displayed_row =
1021     gtk_tree_row_reference_new (cell_view->priv->model, path);
1022
1023   gtk_cell_view_size_request (GTK_WIDGET (cell_view), requisition);
1024
1025   gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1026   cell_view->priv->displayed_row = tmp;
1027
1028   /* restore actual size info */
1029   gtk_cell_view_size_request (GTK_WIDGET (cell_view), &req);
1030
1031   return TRUE;
1032 }
1033
1034 /**
1035  * gtk_cell_view_set_background_color:
1036  * @cell_view: a #GtkCellView
1037  * @color: the new background color
1038  *
1039  * Sets the background color of @view.
1040  *
1041  * Since: 2.6
1042  */
1043 void
1044 gtk_cell_view_set_background_color (GtkCellView    *cell_view,
1045                                     const GdkColor *color)
1046 {
1047   g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1048
1049   if (color)
1050     {
1051       if (!cell_view->priv->background_set)
1052         {
1053           cell_view->priv->background_set = TRUE;
1054           g_object_notify (G_OBJECT (cell_view), "background_set");
1055         }
1056
1057       cell_view->priv->background = *color;
1058     }
1059   else
1060     {
1061       if (cell_view->priv->background_set)
1062         {
1063           cell_view->priv->background_set = FALSE;
1064           g_object_notify (G_OBJECT (cell_view), "background_set");
1065         }
1066     }
1067
1068   gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1069 }
1070
1071 /**
1072  * gtk_cell_view_get_cell_renderers:
1073  * @cell_view: a #GtkCellView
1074  * 
1075  * Returns the cell renderers which have been added to @cell_view.
1076  *
1077  * Return value: a list of cell renderers. The list, but not the
1078  *   renderers has been newly allocated and should be freed with
1079  *   g_list_free() when no longer needed.
1080  * 
1081  * Since: 2.6
1082  */
1083 GList *
1084 gtk_cell_view_get_cell_renderers (GtkCellView *cell_view)
1085 {
1086   GList *retval = NULL, *list;
1087
1088   g_return_val_if_fail (cell_view != NULL, NULL);
1089
1090   gtk_cell_view_set_cell_data (cell_view);
1091
1092   for (list = cell_view->priv->cell_list; list; list = list->next)
1093     {
1094       GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1095
1096       retval = g_list_prepend (retval, info->cell);
1097     }
1098
1099   return g_list_reverse (retval);
1100 }
1101
1102 #define __GTK_CELL_VIEW_C__
1103 #include "gtkaliasdef.c"