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