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