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