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
G_DEFINE_TYPE_WITH_CODE(GtkCellView,gtk_cell_view,GTK_TYPE_WIDGET,G_IMPLEMENT_INTERFACE (GTK_TYPE_CELL_LAYOUT,gtk_cell_view_cell_layout_init)G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,gtk_cell_view_buildable_init))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
gtk_cell_view_buildable_init(GtkBuildableIface * iface)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
gtk_cell_view_cell_layout_init(GtkCellLayoutIface * iface)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
gtk_cell_view_get_property(GObject * object,guint param_id,GValue * value,GParamSpec * pspec)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
gtk_cell_view_set_property(GObject * object,guint param_id,const GValue * value,GParamSpec * pspec)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
gtk_cell_view_init(GtkCellView * cellview)289 gtk_cell_view_init (GtkCellView *cellview)
290 {
291 gtk_widget_set_has_window (GTK_WIDGET (cellview), FALSE);
292
293 cellview->priv = GTK_CELL_VIEW_GET_PRIVATE (cellview);
294 }
295
296 static void
gtk_cell_view_finalize(GObject * object)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
gtk_cell_view_size_request(GtkWidget * widget,GtkRequisition * requisition)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
gtk_cell_view_size_allocate(GtkWidget * widget,GtkAllocation * allocation)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
gtk_cell_view_expose(GtkWidget * widget,GdkEventExpose * event)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_is_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_get_state (widget) == GTK_STATE_PRELIGHT)
440 state = GTK_CELL_RENDERER_PRELIT;
441 else if (gtk_widget_get_state (widget) == GTK_STATE_INSENSITIVE)
442 state = GTK_CELL_RENDERER_INSENSITIVE;
443 else
444 state = 0;
445
446 /* PACK_START */
447 for (i = cellview->priv->cell_list; i; i = i->next)
448 {
449 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
450
451 if (info->pack == GTK_PACK_END)
452 continue;
453
454 if (!info->cell->visible)
455 continue;
456
457 area.width = info->real_width;
458 if (rtl)
459 area.x -= area.width;
460
461 gtk_cell_renderer_render (info->cell,
462 event->window,
463 widget,
464 /* FIXME! */
465 &area, &area, &event->area, state);
466
467 if (!rtl)
468 area.x += info->real_width;
469 }
470
471 area.x = rtl ? widget->allocation.x : (widget->allocation.x + widget->allocation.width);
472
473 /* PACK_END */
474 for (i = cellview->priv->cell_list; i; i = i->next)
475 {
476 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
477
478 if (info->pack == GTK_PACK_START)
479 continue;
480
481 if (!info->cell->visible)
482 continue;
483
484 area.width = info->real_width;
485 if (!rtl)
486 area.x -= area.width;
487
488 gtk_cell_renderer_render (info->cell,
489 widget->window,
490 widget,
491 /* FIXME ! */
492 &area, &area, &event->area, state);
493 if (rtl)
494 area.x += info->real_width;
495 }
496
497 return FALSE;
498 }
499
500 static GtkCellViewCellInfo *
gtk_cell_view_get_cell_info(GtkCellView * cellview,GtkCellRenderer * renderer)501 gtk_cell_view_get_cell_info (GtkCellView *cellview,
502 GtkCellRenderer *renderer)
503 {
504 GList *i;
505
506 for (i = cellview->priv->cell_list; i; i = i->next)
507 {
508 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)i->data;
509
510 if (info->cell == renderer)
511 return info;
512 }
513
514 return NULL;
515 }
516
517 static void
gtk_cell_view_set_cell_data(GtkCellView * cell_view)518 gtk_cell_view_set_cell_data (GtkCellView *cell_view)
519 {
520 GList *i;
521 GtkTreeIter iter;
522 GtkTreePath *path;
523
524 g_return_if_fail (cell_view->priv->displayed_row != NULL);
525
526 path = gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
527 if (!path)
528 return;
529
530 gtk_tree_model_get_iter (cell_view->priv->model, &iter, path);
531 gtk_tree_path_free (path);
532
533 for (i = cell_view->priv->cell_list; i; i = i->next)
534 {
535 GSList *j;
536 GtkCellViewCellInfo *info = i->data;
537
538 g_object_freeze_notify (G_OBJECT (info->cell));
539
540 for (j = info->attributes; j && j->next; j = j->next->next)
541 {
542 gchar *property = j->data;
543 gint column = GPOINTER_TO_INT (j->next->data);
544 GValue value = {0, };
545
546 gtk_tree_model_get_value (cell_view->priv->model, &iter,
547 column, &value);
548 g_object_set_property (G_OBJECT (info->cell),
549 property, &value);
550 g_value_unset (&value);
551 }
552
553 if (info->func)
554 (* info->func) (GTK_CELL_LAYOUT (cell_view),
555 info->cell,
556 cell_view->priv->model,
557 &iter,
558 info->func_data);
559
560 g_object_thaw_notify (G_OBJECT (info->cell));
561 }
562 }
563
564 /* GtkCellLayout implementation */
565 static void
gtk_cell_view_cell_layout_pack_start(GtkCellLayout * layout,GtkCellRenderer * renderer,gboolean expand)566 gtk_cell_view_cell_layout_pack_start (GtkCellLayout *layout,
567 GtkCellRenderer *renderer,
568 gboolean expand)
569 {
570 GtkCellViewCellInfo *info;
571 GtkCellView *cellview = GTK_CELL_VIEW (layout);
572
573 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
574
575 g_object_ref_sink (renderer);
576
577 info = g_slice_new0 (GtkCellViewCellInfo);
578 info->cell = renderer;
579 info->expand = expand ? TRUE : FALSE;
580 info->pack = GTK_PACK_START;
581
582 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
583
584 gtk_widget_queue_resize (GTK_WIDGET (cellview));
585 }
586
587 static void
gtk_cell_view_cell_layout_pack_end(GtkCellLayout * layout,GtkCellRenderer * renderer,gboolean expand)588 gtk_cell_view_cell_layout_pack_end (GtkCellLayout *layout,
589 GtkCellRenderer *renderer,
590 gboolean expand)
591 {
592 GtkCellViewCellInfo *info;
593 GtkCellView *cellview = GTK_CELL_VIEW (layout);
594
595 g_return_if_fail (!gtk_cell_view_get_cell_info (cellview, renderer));
596
597 g_object_ref_sink (renderer);
598
599 info = g_slice_new0 (GtkCellViewCellInfo);
600 info->cell = renderer;
601 info->expand = expand ? TRUE : FALSE;
602 info->pack = GTK_PACK_END;
603
604 cellview->priv->cell_list = g_list_append (cellview->priv->cell_list, info);
605
606 gtk_widget_queue_resize (GTK_WIDGET (cellview));
607 }
608
609 static void
gtk_cell_view_cell_layout_add_attribute(GtkCellLayout * layout,GtkCellRenderer * renderer,const gchar * attribute,gint column)610 gtk_cell_view_cell_layout_add_attribute (GtkCellLayout *layout,
611 GtkCellRenderer *renderer,
612 const gchar *attribute,
613 gint column)
614 {
615 GtkCellViewCellInfo *info;
616 GtkCellView *cellview = GTK_CELL_VIEW (layout);
617
618 info = gtk_cell_view_get_cell_info (cellview, renderer);
619 g_return_if_fail (info != NULL);
620
621 info->attributes = g_slist_prepend (info->attributes,
622 GINT_TO_POINTER (column));
623 info->attributes = g_slist_prepend (info->attributes,
624 g_strdup (attribute));
625 }
626
627 static void
gtk_cell_view_cell_layout_clear(GtkCellLayout * layout)628 gtk_cell_view_cell_layout_clear (GtkCellLayout *layout)
629 {
630 GtkCellView *cellview = GTK_CELL_VIEW (layout);
631
632 while (cellview->priv->cell_list)
633 {
634 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)cellview->priv->cell_list->data;
635
636 gtk_cell_view_cell_layout_clear_attributes (layout, info->cell);
637 g_object_unref (info->cell);
638 g_slice_free (GtkCellViewCellInfo, info);
639 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
640 cellview->priv->cell_list);
641 }
642
643 gtk_widget_queue_resize (GTK_WIDGET (cellview));
644 }
645
646 static void
gtk_cell_view_cell_layout_set_cell_data_func(GtkCellLayout * layout,GtkCellRenderer * cell,GtkCellLayoutDataFunc func,gpointer func_data,GDestroyNotify destroy)647 gtk_cell_view_cell_layout_set_cell_data_func (GtkCellLayout *layout,
648 GtkCellRenderer *cell,
649 GtkCellLayoutDataFunc func,
650 gpointer func_data,
651 GDestroyNotify destroy)
652 {
653 GtkCellView *cellview = GTK_CELL_VIEW (layout);
654 GtkCellViewCellInfo *info;
655
656 info = gtk_cell_view_get_cell_info (cellview, cell);
657 g_return_if_fail (info != NULL);
658
659 if (info->destroy)
660 {
661 GDestroyNotify d = info->destroy;
662
663 info->destroy = NULL;
664 d (info->func_data);
665 }
666
667 info->func = func;
668 info->func_data = func_data;
669 info->destroy = destroy;
670 }
671
672 static void
gtk_cell_view_cell_layout_clear_attributes(GtkCellLayout * layout,GtkCellRenderer * renderer)673 gtk_cell_view_cell_layout_clear_attributes (GtkCellLayout *layout,
674 GtkCellRenderer *renderer)
675 {
676 GtkCellView *cellview = GTK_CELL_VIEW (layout);
677 GtkCellViewCellInfo *info;
678 GSList *list;
679
680 info = gtk_cell_view_get_cell_info (cellview, renderer);
681 if (info != NULL)
682 {
683 list = info->attributes;
684 while (list && list->next)
685 {
686 g_free (list->data);
687 list = list->next->next;
688 }
689
690 g_slist_free (info->attributes);
691 info->attributes = NULL;
692 }
693 }
694
695 static void
gtk_cell_view_cell_layout_reorder(GtkCellLayout * layout,GtkCellRenderer * cell,gint position)696 gtk_cell_view_cell_layout_reorder (GtkCellLayout *layout,
697 GtkCellRenderer *cell,
698 gint position)
699 {
700 GtkCellView *cellview = GTK_CELL_VIEW (layout);
701 GtkCellViewCellInfo *info;
702 GList *link;
703
704 info = gtk_cell_view_get_cell_info (cellview, cell);
705
706 g_return_if_fail (info != NULL);
707 g_return_if_fail (position >= 0);
708
709 link = g_list_find (cellview->priv->cell_list, info);
710
711 g_return_if_fail (link != NULL);
712
713 cellview->priv->cell_list = g_list_delete_link (cellview->priv->cell_list,
714 link);
715 cellview->priv->cell_list = g_list_insert (cellview->priv->cell_list,
716 info, position);
717
718 gtk_widget_queue_draw (GTK_WIDGET (cellview));
719 }
720
721 /**
722 * gtk_cell_view_new:
723 *
724 * Creates a new #GtkCellView widget.
725 *
726 * Return value: A newly created #GtkCellView widget.
727 *
728 * Since: 2.6
729 */
730 GtkWidget *
gtk_cell_view_new(void)731 gtk_cell_view_new (void)
732 {
733 GtkCellView *cellview;
734
735 cellview = g_object_new (gtk_cell_view_get_type (), NULL);
736
737 return GTK_WIDGET (cellview);
738 }
739
740 /**
741 * gtk_cell_view_new_with_text:
742 * @text: the text to display in the cell view
743 *
744 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
745 * to it, and makes its show @text.
746 *
747 * Return value: A newly created #GtkCellView widget.
748 *
749 * Since: 2.6
750 */
751 GtkWidget *
gtk_cell_view_new_with_text(const gchar * text)752 gtk_cell_view_new_with_text (const gchar *text)
753 {
754 GtkCellView *cellview;
755 GtkCellRenderer *renderer;
756 GValue value = {0, };
757
758 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
759
760 renderer = gtk_cell_renderer_text_new ();
761 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
762 renderer, TRUE);
763
764 g_value_init (&value, G_TYPE_STRING);
765 g_value_set_string (&value, text);
766 gtk_cell_view_set_value (cellview, renderer, "text", &value);
767 g_value_unset (&value);
768
769 return GTK_WIDGET (cellview);
770 }
771
772 /**
773 * gtk_cell_view_new_with_markup:
774 * @markup: the text to display in the cell view
775 *
776 * Creates a new #GtkCellView widget, adds a #GtkCellRendererText
777 * to it, and makes it show @markup. The text can be
778 * marked up with the <link linkend="PangoMarkupFormat">Pango text
779 * markup language</link>.
780 *
781 * Return value: A newly created #GtkCellView widget.
782 *
783 * Since: 2.6
784 */
785 GtkWidget *
gtk_cell_view_new_with_markup(const gchar * markup)786 gtk_cell_view_new_with_markup (const gchar *markup)
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, markup);
800 gtk_cell_view_set_value (cellview, renderer, "markup", &value);
801 g_value_unset (&value);
802
803 return GTK_WIDGET (cellview);
804 }
805
806 /**
807 * gtk_cell_view_new_with_pixbuf:
808 * @pixbuf: the image to display in the cell view
809 *
810 * Creates a new #GtkCellView widget, adds a #GtkCellRendererPixbuf
811 * to it, and makes its show @pixbuf.
812 *
813 * Return value: A newly created #GtkCellView widget.
814 *
815 * Since: 2.6
816 */
817 GtkWidget *
gtk_cell_view_new_with_pixbuf(GdkPixbuf * pixbuf)818 gtk_cell_view_new_with_pixbuf (GdkPixbuf *pixbuf)
819 {
820 GtkCellView *cellview;
821 GtkCellRenderer *renderer;
822 GValue value = {0, };
823
824 cellview = GTK_CELL_VIEW (gtk_cell_view_new ());
825
826 renderer = gtk_cell_renderer_pixbuf_new ();
827 gtk_cell_view_cell_layout_pack_start (GTK_CELL_LAYOUT (cellview),
828 renderer, TRUE);
829
830 g_value_init (&value, GDK_TYPE_PIXBUF);
831 g_value_set_object (&value, pixbuf);
832 gtk_cell_view_set_value (cellview, renderer, "pixbuf", &value);
833 g_value_unset (&value);
834
835 return GTK_WIDGET (cellview);
836 }
837
838 /**
839 * gtk_cell_view_set_value:
840 * @cell_view: a #GtkCellView widget
841 * @renderer: one of the renderers of @cell_view
842 * @property: the name of the property of @renderer to set
843 * @value: the new value to set the property to
844 *
845 * Sets a property of a cell renderer of @cell_view, and
846 * makes sure the display of @cell_view is updated.
847 *
848 * Since: 2.6
849 */
850 static void
gtk_cell_view_set_value(GtkCellView * cell_view,GtkCellRenderer * renderer,gchar * property,GValue * value)851 gtk_cell_view_set_value (GtkCellView *cell_view,
852 GtkCellRenderer *renderer,
853 gchar *property,
854 GValue *value)
855 {
856 g_object_set_property (G_OBJECT (renderer), property, value);
857
858 /* force resize and redraw */
859 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
860 }
861
862 /**
863 * gtk_cell_view_set_model:
864 * @cell_view: a #GtkCellView
865 * @model: (allow-none): a #GtkTreeModel
866 *
867 * Sets the model for @cell_view. If @cell_view already has a model
868 * set, it will remove it before setting the new model. If @model is
869 * %NULL, then it will unset the old model.
870 *
871 * Since: 2.6
872 */
873 void
gtk_cell_view_set_model(GtkCellView * cell_view,GtkTreeModel * model)874 gtk_cell_view_set_model (GtkCellView *cell_view,
875 GtkTreeModel *model)
876 {
877 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
878 g_return_if_fail (model == NULL || GTK_IS_TREE_MODEL (model));
879
880 if (cell_view->priv->model)
881 {
882 if (cell_view->priv->displayed_row)
883 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
884 cell_view->priv->displayed_row = NULL;
885
886 g_object_unref (cell_view->priv->model);
887 cell_view->priv->model = NULL;
888 }
889
890 cell_view->priv->model = model;
891
892 if (cell_view->priv->model)
893 g_object_ref (cell_view->priv->model);
894
895 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
896 }
897
898 /**
899 * gtk_cell_view_get_model:
900 * @cell_view: a #GtkCellView
901 *
902 * Returns the model for @cell_view. If no model is used %NULL is
903 * returned.
904 *
905 * Returns: (transfer none): a #GtkTreeModel used or %NULL
906 *
907 * Since: 2.16
908 **/
909 GtkTreeModel *
gtk_cell_view_get_model(GtkCellView * cell_view)910 gtk_cell_view_get_model (GtkCellView *cell_view)
911 {
912 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
913
914 return cell_view->priv->model;
915 }
916
917 /**
918 * gtk_cell_view_set_displayed_row:
919 * @cell_view: a #GtkCellView
920 * @path: (allow-none): a #GtkTreePath or %NULL to unset.
921 *
922 * Sets the row of the model that is currently displayed
923 * by the #GtkCellView. If the path is unset, then the
924 * contents of the cellview "stick" at their last value;
925 * this is not normally a desired result, but may be
926 * a needed intermediate state if say, the model for
927 * the #GtkCellView becomes temporarily empty.
928 *
929 * Since: 2.6
930 **/
931 void
gtk_cell_view_set_displayed_row(GtkCellView * cell_view,GtkTreePath * path)932 gtk_cell_view_set_displayed_row (GtkCellView *cell_view,
933 GtkTreePath *path)
934 {
935 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
936 g_return_if_fail (GTK_IS_TREE_MODEL (cell_view->priv->model));
937
938 if (cell_view->priv->displayed_row)
939 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
940
941 if (path)
942 {
943 cell_view->priv->displayed_row =
944 gtk_tree_row_reference_new (cell_view->priv->model, path);
945 }
946 else
947 cell_view->priv->displayed_row = NULL;
948
949 /* force resize and redraw */
950 gtk_widget_queue_resize (GTK_WIDGET (cell_view));
951 }
952
953 /**
954 * gtk_cell_view_get_displayed_row:
955 * @cell_view: a #GtkCellView
956 *
957 * Returns a #GtkTreePath referring to the currently
958 * displayed row. If no row is currently displayed,
959 * %NULL is returned.
960 *
961 * Returns: the currently displayed row or %NULL
962 *
963 * Since: 2.6
964 */
965 GtkTreePath *
gtk_cell_view_get_displayed_row(GtkCellView * cell_view)966 gtk_cell_view_get_displayed_row (GtkCellView *cell_view)
967 {
968 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), NULL);
969
970 if (!cell_view->priv->displayed_row)
971 return NULL;
972
973 return gtk_tree_row_reference_get_path (cell_view->priv->displayed_row);
974 }
975
976 /**
977 * gtk_cell_view_get_size_of_row:
978 * @cell_view: a #GtkCellView
979 * @path: a #GtkTreePath
980 * @requisition: (out): return location for the size
981 *
982 * Sets @requisition to the size needed by @cell_view to display
983 * the model row pointed to by @path.
984 *
985 * Return value: %TRUE
986 *
987 * Since: 2.6
988 */
989 gboolean
gtk_cell_view_get_size_of_row(GtkCellView * cell_view,GtkTreePath * path,GtkRequisition * requisition)990 gtk_cell_view_get_size_of_row (GtkCellView *cell_view,
991 GtkTreePath *path,
992 GtkRequisition *requisition)
993 {
994 GtkTreeRowReference *tmp;
995 GtkRequisition req;
996
997 g_return_val_if_fail (GTK_IS_CELL_VIEW (cell_view), FALSE);
998 g_return_val_if_fail (path != NULL, FALSE);
999 g_return_val_if_fail (requisition != NULL, FALSE);
1000
1001 tmp = cell_view->priv->displayed_row;
1002 cell_view->priv->displayed_row =
1003 gtk_tree_row_reference_new (cell_view->priv->model, path);
1004
1005 gtk_cell_view_size_request (GTK_WIDGET (cell_view), requisition);
1006
1007 gtk_tree_row_reference_free (cell_view->priv->displayed_row);
1008 cell_view->priv->displayed_row = tmp;
1009
1010 /* restore actual size info */
1011 gtk_cell_view_size_request (GTK_WIDGET (cell_view), &req);
1012
1013 return TRUE;
1014 }
1015
1016 /**
1017 * gtk_cell_view_set_background_color:
1018 * @cell_view: a #GtkCellView
1019 * @color: the new background color
1020 *
1021 * Sets the background color of @view.
1022 *
1023 * Since: 2.6
1024 */
1025 void
gtk_cell_view_set_background_color(GtkCellView * cell_view,const GdkColor * color)1026 gtk_cell_view_set_background_color (GtkCellView *cell_view,
1027 const GdkColor *color)
1028 {
1029 g_return_if_fail (GTK_IS_CELL_VIEW (cell_view));
1030
1031 if (color)
1032 {
1033 if (!cell_view->priv->background_set)
1034 {
1035 cell_view->priv->background_set = TRUE;
1036 g_object_notify (G_OBJECT (cell_view), "background-set");
1037 }
1038
1039 cell_view->priv->background = *color;
1040 }
1041 else
1042 {
1043 if (cell_view->priv->background_set)
1044 {
1045 cell_view->priv->background_set = FALSE;
1046 g_object_notify (G_OBJECT (cell_view), "background-set");
1047 }
1048 }
1049
1050 gtk_widget_queue_draw (GTK_WIDGET (cell_view));
1051 }
1052
1053 static GList *
gtk_cell_view_cell_layout_get_cells(GtkCellLayout * layout)1054 gtk_cell_view_cell_layout_get_cells (GtkCellLayout *layout)
1055 {
1056 GtkCellView *cell_view = GTK_CELL_VIEW (layout);
1057 GList *retval = NULL, *list;
1058
1059 g_return_val_if_fail (cell_view != NULL, NULL);
1060
1061 gtk_cell_view_set_cell_data (cell_view);
1062
1063 for (list = cell_view->priv->cell_list; list; list = list->next)
1064 {
1065 GtkCellViewCellInfo *info = (GtkCellViewCellInfo *)list->data;
1066
1067 retval = g_list_prepend (retval, info->cell);
1068 }
1069
1070 return g_list_reverse (retval);
1071 }
1072
1073 /**
1074 * gtk_cell_view_get_cell_renderers:
1075 * @cell_view: a #GtkCellView
1076 *
1077 * Returns the cell renderers which have been added to @cell_view.
1078 *
1079 * Return value: a list of cell renderers. The list, but not the
1080 * renderers has been newly allocated and should be freed with
1081 * g_list_free() when no longer needed.
1082 *
1083 * Since: 2.6
1084 *
1085 * Deprecated: 2.18: use gtk_cell_layout_get_cells() instead.
1086 **/
1087 GList *
gtk_cell_view_get_cell_renderers(GtkCellView * cell_view)1088 gtk_cell_view_get_cell_renderers (GtkCellView *cell_view)
1089 {
1090 return gtk_cell_view_cell_layout_get_cells (GTK_CELL_LAYOUT (cell_view));
1091 }
1092
1093 static gboolean
gtk_cell_view_buildable_custom_tag_start(GtkBuildable * buildable,GtkBuilder * builder,GObject * child,const gchar * tagname,GMarkupParser * parser,gpointer * data)1094 gtk_cell_view_buildable_custom_tag_start (GtkBuildable *buildable,
1095 GtkBuilder *builder,
1096 GObject *child,
1097 const gchar *tagname,
1098 GMarkupParser *parser,
1099 gpointer *data)
1100 {
1101 if (parent_buildable_iface->custom_tag_start &&
1102 parent_buildable_iface->custom_tag_start (buildable, builder, child,
1103 tagname, parser, data))
1104 return TRUE;
1105
1106 return _gtk_cell_layout_buildable_custom_tag_start (buildable, builder, child,
1107 tagname, parser, data);
1108 }
1109
1110 static void
gtk_cell_view_buildable_custom_tag_end(GtkBuildable * buildable,GtkBuilder * builder,GObject * child,const gchar * tagname,gpointer * data)1111 gtk_cell_view_buildable_custom_tag_end (GtkBuildable *buildable,
1112 GtkBuilder *builder,
1113 GObject *child,
1114 const gchar *tagname,
1115 gpointer *data)
1116 {
1117 if (strcmp (tagname, "attributes") == 0)
1118 _gtk_cell_layout_buildable_custom_tag_end (buildable, builder, child, tagname,
1119 data);
1120 else if (parent_buildable_iface->custom_tag_end)
1121 parent_buildable_iface->custom_tag_end (buildable, builder, child, tagname,
1122 data);
1123 }
1124
1125
1126 #define __GTK_CELL_VIEW_C__
1127 #include "gtkaliasdef.c"
1128