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