Pileus Git - ~andy/gtk/blob - gtk/gtkcellrenderer.c

   1 /* gtkcellrenderer.c
   2  * Copyright (C) 2000  Red Hat, Inc. Jonathan Blandford
   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 "gtkcellrenderer.h"
  22 #include "gtkcellsizerequest.h"
  23 #include "gtkintl.h"
  24 #include "gtkmarshalers.h"
  25 #include "gtkprivate.h"
  26 #include "gtktreeprivate.h"
  27
  28
  29 static void gtk_cell_renderer_init          (GtkCellRenderer      *cell);
  30 static void gtk_cell_renderer_class_init    (GtkCellRendererClass *class);
  31 static void gtk_cell_renderer_get_property  (GObject              *object,
  32                                              guint                 param_id,
  33                                              GValue               *value,
  34                                              GParamSpec           *pspec);
  35 static void gtk_cell_renderer_set_property  (GObject              *object,
  36                                              guint                 param_id,
  37                                              const GValue         *value,
  38                                              GParamSpec           *pspec);
  39 static void set_cell_bg_color               (GtkCellRenderer      *cell,
  40                                              GdkColor             *color);
  41
  42 /* Fallback GtkCellSizeRequest implementation to use remaining ->get_size() implementations */
  43 static void gtk_cell_renderer_cell_size_request_init   (GtkCellSizeRequestIface *iface);
  44 static void gtk_cell_renderer_get_width                (GtkCellSizeRequest      *cell,
  45                                                         GtkWidget               *widget,
  46                                                         gint                    *minimum_size,
  47                                                         gint                    *natural_size);
  48 static void gtk_cell_renderer_get_height               (GtkCellSizeRequest      *cell,
  49                                                         GtkWidget               *widget,
  50                                                         gint                    *minimum_size,
  51                                                         gint                    *natural_size);
  52 static void gtk_cell_renderer_get_height_for_width     (GtkCellSizeRequest      *cell,
  53                                                         GtkWidget               *widget,
  54                                                         gint                     width,
  55                                                         gint                    *minimum_height,
  56                                                         gint                    *natural_height);
  57 static void gtk_cell_renderer_get_width_for_height     (GtkCellSizeRequest      *cell,
  58                                                         GtkWidget               *widget,
  59                                                         gint                     height,
  60                                                         gint                    *minimum_width,
  61                                                         gint                    *natural_width);
  62
  63
  64
  65 struct _GtkCellRendererPrivate
  66 {
  67   gfloat xalign;
  68   gfloat yalign;
  69
  70   gint width;
  71   gint height;
  72
  73   guint16 xpad;
  74   guint16 ypad;
  75
  76   guint mode                : 2;
  77   guint visible             : 1;
  78   guint is_expander         : 1;
  79   guint is_expanded         : 1;
  80   guint cell_background_set : 1;
  81   guint sensitive           : 1;
  82   guint editing             : 1;
  83
  84   GdkColor cell_background;
  85 };
  86
  87
  88 enum {
  89   PROP_0,
  90   PROP_MODE,
  91   PROP_VISIBLE,
  92   PROP_SENSITIVE,
  93   PROP_XALIGN,
  94   PROP_YALIGN,
  95   PROP_XPAD,
  96   PROP_YPAD,
  97   PROP_WIDTH,
  98   PROP_HEIGHT,
  99   PROP_IS_EXPANDER,
 100   PROP_IS_EXPANDED,
 101   PROP_CELL_BACKGROUND,
 102   PROP_CELL_BACKGROUND_GDK,
 103   PROP_CELL_BACKGROUND_SET,
 104   PROP_EDITING
 105 };
 106
 107 /* Signal IDs */
 108 enum {
 109   EDITING_CANCELED,
 110   EDITING_STARTED,
 111   LAST_SIGNAL
 112 };
 113
 114 static guint  cell_renderer_signals[LAST_SIGNAL] = { 0 };
 115
 116
 117 /* Do a manual _get_type() here to avoid a deadlock implementing
 118  * the interface which we are a prerequisite of.
 119  */
 120 GType
 121 gtk_cell_renderer_get_type (void)
 122 {
 123   static GType cell_renderer_type = 0;
 124
 125   if (G_UNLIKELY (cell_renderer_type == 0))
 126     {
 127       const GTypeInfo cell_renderer_info =
 128       {
 129         sizeof (GtkCellRendererClass),
 130         NULL,           /* base_init */
 131         NULL,           /* base_finalize */
 132         (GClassInitFunc) gtk_cell_renderer_class_init,
 133         NULL,           /* class_finalize */
 134         NULL,           /* class_init */
 135         sizeof (GtkCellRenderer),
 136         0,              /* n_preallocs */
 137         (GInstanceInitFunc) gtk_cell_renderer_init,
 138         NULL,           /* value_table */
 139       };
 140
 141       const GInterfaceInfo cell_size_request_info =
 142       {
 143         (GInterfaceInitFunc) gtk_cell_renderer_cell_size_request_init,
 144         (GInterfaceFinalizeFunc) NULL,
 145         NULL /* interface data */
 146       };
 147
 148       cell_renderer_type = g_type_register_static (GTK_TYPE_OBJECT, "GtkCellRenderer",
 149                                                    &cell_renderer_info, G_TYPE_FLAG_ABSTRACT);
 150
 151       g_type_add_interface_static (cell_renderer_type, GTK_TYPE_CELL_SIZE_REQUEST,
 152                                    &cell_size_request_info) ;
 153     }
 154
 155   return cell_renderer_type;
 156 }
 157
 158
 159 static void
 160 gtk_cell_renderer_init (GtkCellRenderer *cell)
 161 {
 162   GtkCellRendererPrivate *priv;
 163
 164   cell->priv = G_TYPE_INSTANCE_GET_PRIVATE (cell,
 165                                             GTK_TYPE_CELL_RENDERER,
 166                                             GtkCellRendererPrivate);
 167   priv = cell->priv;
 168
 169   priv->mode = GTK_CELL_RENDERER_MODE_INERT;
 170   priv->visible = TRUE;
 171   priv->width = -1;
 172   priv->height = -1;
 173   priv->xalign = 0.5;
 174   priv->yalign = 0.5;
 175   priv->xpad = 0;
 176   priv->ypad = 0;
 177   priv->sensitive = TRUE;
 178   priv->is_expander = FALSE;
 179   priv->is_expanded = FALSE;
 180   priv->editing = FALSE;
 181 }
 182
 183 static void
 184 gtk_cell_renderer_class_init (GtkCellRendererClass *class)
 185 {
 186   GObjectClass *object_class = G_OBJECT_CLASS (class);
 187
 188   object_class->get_property = gtk_cell_renderer_get_property;
 189   object_class->set_property = gtk_cell_renderer_set_property;
 190
 191   class->render = NULL;
 192   class->get_size = NULL;
 193
 194   /**
 195    * GtkCellRenderer::editing-canceled:
 196    * @renderer: the object which received the signal
 197    *
 198    * This signal gets emitted when the user cancels the process of editing a
 199    * cell.  For example, an editable cell renderer could be written to cancel
 200    * editing when the user presses Escape.
 201    *
 202    * See also: gtk_cell_renderer_stop_editing().
 203    *
 204    * Since: 2.4
 205    */
 206   cell_renderer_signals[EDITING_CANCELED] =
 207     g_signal_new (I_("editing-canceled"),
 208                   G_OBJECT_CLASS_TYPE (object_class),
 209                   G_SIGNAL_RUN_FIRST,
 210                   G_STRUCT_OFFSET (GtkCellRendererClass, editing_canceled),
 211                   NULL, NULL,
 212                   _gtk_marshal_VOID__VOID,
 213                   G_TYPE_NONE, 0);
 214
 215   /**
 216    * GtkCellRenderer::editing-started:
 217    * @renderer: the object which received the signal
 218    * @editable: the #GtkCellEditable
 219    * @path: the path identifying the edited cell
 220    *
 221    * This signal gets emitted when a cell starts to be edited.
 222    * The intended use of this signal is to do special setup
 223    * on @editable, e.g. adding a #GtkEntryCompletion or setting
 224    * up additional columns in a #GtkComboBox.
 225    *
 226    * Note that GTK+ doesn't guarantee that cell renderers will
 227    * continue to use the same kind of widget for editing in future
 228    * releases, therefore you should check the type of @editable
 229    * before doing any specific setup, as in the following example:
 230    * |[
 231    * static void
 232    * text_editing_started (GtkCellRenderer *cell,
 233    *                       GtkCellEditable *editable,
 234    *                       const gchar     *path,
 235    *                       gpointer         data)
 236    * {
 237    *   if (GTK_IS_ENTRY (editable))
 238    *     {
 239    *       GtkEntry *entry = GTK_ENTRY (editable);
 240    *
 241    *       /&ast; ... create a GtkEntryCompletion &ast;/
 242    *
 243    *       gtk_entry_set_completion (entry, completion);
 244    *     }
 245    * }
 246    * ]|
 247    *
 248    * Since: 2.6
 249    */
 250   cell_renderer_signals[EDITING_STARTED] =
 251     g_signal_new (I_("editing-started"),
 252                   G_OBJECT_CLASS_TYPE (object_class),
 253                   G_SIGNAL_RUN_FIRST,
 254                   G_STRUCT_OFFSET (GtkCellRendererClass, editing_started),
 255                   NULL, NULL,
 256                   _gtk_marshal_VOID__OBJECT_STRING,
 257                   G_TYPE_NONE, 2,
 258                   GTK_TYPE_CELL_EDITABLE,
 259                   G_TYPE_STRING);
 260
 261   g_object_class_install_property (object_class,
 262                                    PROP_MODE,
 263                                    g_param_spec_enum ("mode",
 264                                                       P_("mode"),
 265                                                       P_("Editable mode of the CellRenderer"),
 266                                                       GTK_TYPE_CELL_RENDERER_MODE,
 267                                                       GTK_CELL_RENDERER_MODE_INERT,
 268                                                       GTK_PARAM_READWRITE));
 269
 270   g_object_class_install_property (object_class,
 271                                    PROP_VISIBLE,
 272                                    g_param_spec_boolean ("visible",
 273                                                          P_("visible"),
 274                                                          P_("Display the cell"),
 275                                                          TRUE,
 276                                                          GTK_PARAM_READWRITE));
 277   g_object_class_install_property (object_class,
 278                                    PROP_SENSITIVE,
 279                                    g_param_spec_boolean ("sensitive",
 280                                                          P_("Sensitive"),
 281                                                          P_("Display the cell sensitive"),
 282                                                          TRUE,
 283                                                          GTK_PARAM_READWRITE));
 284
 285   g_object_class_install_property (object_class,
 286                                    PROP_XALIGN,
 287                                    g_param_spec_float ("xalign",
 288                                                        P_("xalign"),
 289                                                        P_("The x-align"),
 290                                                        0.0,
 291                                                        1.0,
 292                                                        0.5,
 293                                                        GTK_PARAM_READWRITE));
 294
 295   g_object_class_install_property (object_class,
 296                                    PROP_YALIGN,
 297                                    g_param_spec_float ("yalign",
 298                                                        P_("yalign"),
 299                                                        P_("The y-align"),
 300                                                        0.0,
 301                                                        1.0,
 302                                                        0.5,
 303                                                        GTK_PARAM_READWRITE));
 304
 305   g_object_class_install_property (object_class,
 306                                    PROP_XPAD,
 307                                    g_param_spec_uint ("xpad",
 308                                                       P_("xpad"),
 309                                                       P_("The xpad"),
 310                                                       0,
 311                                                       G_MAXUINT,
 312                                                       0,
 313                                                       GTK_PARAM_READWRITE));
 314
 315   g_object_class_install_property (object_class,
 316                                    PROP_YPAD,
 317                                    g_param_spec_uint ("ypad",
 318                                                       P_("ypad"),
 319                                                       P_("The ypad"),
 320                                                       0,
 321                                                       G_MAXUINT,
 322                                                       0,
 323                                                       GTK_PARAM_READWRITE));
 324
 325   g_object_class_install_property (object_class,
 326                                    PROP_WIDTH,
 327                                    g_param_spec_int ("width",
 328                                                      P_("width"),
 329                                                      P_("The fixed width"),
 330                                                      -1,
 331                                                      G_MAXINT,
 332                                                      -1,
 333                                                      GTK_PARAM_READWRITE));
 334
 335   g_object_class_install_property (object_class,
 336                                    PROP_HEIGHT,
 337                                    g_param_spec_int ("height",
 338                                                      P_("height"),
 339                                                      P_("The fixed height"),
 340                                                      -1,
 341                                                      G_MAXINT,
 342                                                      -1,
 343                                                      GTK_PARAM_READWRITE));
 344
 345   g_object_class_install_property (object_class,
 346                                    PROP_IS_EXPANDER,
 347                                    g_param_spec_boolean ("is-expander",
 348                                                          P_("Is Expander"),
 349                                                          P_("Row has children"),
 350                                                          FALSE,
 351                                                          GTK_PARAM_READWRITE));
 352
 353
 354   g_object_class_install_property (object_class,
 355                                    PROP_IS_EXPANDED,
 356                                    g_param_spec_boolean ("is-expanded",
 357                                                          P_("Is Expanded"),
 358                                                          P_("Row is an expander row, and is expanded"),
 359                                                          FALSE,
 360                                                          GTK_PARAM_READWRITE));
 361
 362   g_object_class_install_property (object_class,
 363                                    PROP_CELL_BACKGROUND,
 364                                    g_param_spec_string ("cell-background",
 365                                                         P_("Cell background color name"),
 366                                                         P_("Cell background color as a string"),
 367                                                         NULL,
 368                                                         GTK_PARAM_WRITABLE));
 369
 370   g_object_class_install_property (object_class,
 371                                    PROP_CELL_BACKGROUND_GDK,
 372                                    g_param_spec_boxed ("cell-background-gdk",
 373                                                        P_("Cell background color"),
 374                                                        P_("Cell background color as a GdkColor"),
 375                                                        GDK_TYPE_COLOR,
 376                                                        GTK_PARAM_READWRITE));
 377
 378   g_object_class_install_property (object_class,
 379                                    PROP_EDITING,
 380                                    g_param_spec_boolean ("editing",
 381                                                          P_("Editing"),
 382                                                          P_("Whether the cell renderer is currently in editing mode"),
 383                                                          FALSE,
 384                                                          GTK_PARAM_READABLE));
 385
 386
 387 #define ADD_SET_PROP(propname, propval, nick, blurb) g_object_class_install_property (object_class, propval, g_param_spec_boolean (propname, nick, blurb, FALSE, GTK_PARAM_READWRITE))
 388
 389   ADD_SET_PROP ("cell-background-set", PROP_CELL_BACKGROUND_SET,
 390                 P_("Cell background set"),
 391                 P_("Whether this tag affects the cell background color"));
 392
 393   g_type_class_add_private (class, sizeof (GtkCellRendererPrivate));
 394 }
 395
 396 static void
 397 gtk_cell_renderer_get_property (GObject     *object,
 398                                 guint        param_id,
 399                                 GValue      *value,
 400                                 GParamSpec  *pspec)
 401 {
 402   GtkCellRenderer *cell = GTK_CELL_RENDERER (object);
 403   GtkCellRendererPrivate *priv = cell->priv;
 404
 405   switch (param_id)
 406     {
 407     case PROP_MODE:
 408       g_value_set_enum (value, priv->mode);
 409       break;
 410     case PROP_VISIBLE:
 411       g_value_set_boolean (value, priv->visible);
 412       break;
 413     case PROP_SENSITIVE:
 414       g_value_set_boolean (value, priv->sensitive);
 415       break;
 416     case PROP_EDITING:
 417       g_value_set_boolean (value, priv->editing);
 418       break;
 419     case PROP_XALIGN:
 420       g_value_set_float (value, priv->xalign);
 421       break;
 422     case PROP_YALIGN:
 423       g_value_set_float (value, priv->yalign);
 424       break;
 425     case PROP_XPAD:
 426       g_value_set_uint (value, priv->xpad);
 427       break;
 428     case PROP_YPAD:
 429       g_value_set_uint (value, priv->ypad);
 430       break;
 431     case PROP_WIDTH:
 432       g_value_set_int (value, priv->width);
 433       break;
 434     case PROP_HEIGHT:
 435       g_value_set_int (value, priv->height);
 436       break;
 437     case PROP_IS_EXPANDER:
 438       g_value_set_boolean (value, priv->is_expander);
 439       break;
 440     case PROP_IS_EXPANDED:
 441       g_value_set_boolean (value, priv->is_expanded);
 442       break;
 443     case PROP_CELL_BACKGROUND_GDK:
 444       {
 445         GdkColor color;
 446
 447         color.red = priv->cell_background.red;
 448         color.green = priv->cell_background.green;
 449         color.blue = priv->cell_background.blue;
 450
 451         g_value_set_boxed (value, &color);
 452       }
 453       break;
 454     case PROP_CELL_BACKGROUND_SET:
 455       g_value_set_boolean (value, priv->cell_background_set);
 456       break;
 457     case PROP_CELL_BACKGROUND:
 458     default:
 459       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
 460       break;
 461     }
 462
 463 }
 464
 465 static void
 466 gtk_cell_renderer_set_property (GObject      *object,
 467                                 guint         param_id,
 468                                 const GValue *value,
 469                                 GParamSpec   *pspec)
 470 {
 471   GtkCellRenderer *cell = GTK_CELL_RENDERER (object);
 472   GtkCellRendererPrivate *priv = cell->priv;
 473
 474   switch (param_id)
 475     {
 476     case PROP_MODE:
 477       priv->mode = g_value_get_enum (value);
 478       break;
 479     case PROP_VISIBLE:
 480       priv->visible = g_value_get_boolean (value);
 481       break;
 482     case PROP_SENSITIVE:
 483       priv->sensitive = g_value_get_boolean (value);
 484       break;
 485     case PROP_EDITING:
 486       priv->editing = g_value_get_boolean (value);
 487       break;
 488     case PROP_XALIGN:
 489       priv->xalign = g_value_get_float (value);
 490       break;
 491     case PROP_YALIGN:
 492       priv->yalign = g_value_get_float (value);
 493       break;
 494     case PROP_XPAD:
 495       priv->xpad = g_value_get_uint (value);
 496       break;
 497     case PROP_YPAD:
 498       priv->ypad = g_value_get_uint (value);
 499       break;
 500     case PROP_WIDTH:
 501       priv->width = g_value_get_int (value);
 502       break;
 503     case PROP_HEIGHT:
 504       priv->height = g_value_get_int (value);
 505       break;
 506     case PROP_IS_EXPANDER:
 507       priv->is_expander = g_value_get_boolean (value);
 508       break;
 509     case PROP_IS_EXPANDED:
 510       priv->is_expanded = g_value_get_boolean (value);
 511       break;
 512     case PROP_CELL_BACKGROUND:
 513       {
 514         GdkColor color;
 515
 516         if (!g_value_get_string (value))
 517           set_cell_bg_color (cell, NULL);
 518         else if (gdk_color_parse (g_value_get_string (value), &color))
 519           set_cell_bg_color (cell, &color);
 520         else
 521           g_warning ("Don't know color `%s'", g_value_get_string (value));
 522
 523         g_object_notify (object, "cell-background-gdk");
 524       }
 525       break;
 526     case PROP_CELL_BACKGROUND_GDK:
 527       set_cell_bg_color (cell, g_value_get_boxed (value));
 528       break;
 529     case PROP_CELL_BACKGROUND_SET:
 530       priv->cell_background_set = g_value_get_boolean (value);
 531       break;
 532     default:
 533       G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
 534       break;
 535     }
 536 }
 537
 538 static void
 539 set_cell_bg_color (GtkCellRenderer *cell,
 540                    GdkColor        *color)
 541 {
 542   GtkCellRendererPrivate *priv = cell->priv;
 543
 544   if (color)
 545     {
 546       if (!priv->cell_background_set)
 547         {
 548           priv->cell_background_set = TRUE;
 549           g_object_notify (G_OBJECT (cell), "cell-background-set");
 550         }
 551
 552       priv->cell_background.red = color->red;
 553       priv->cell_background.green = color->green;
 554       priv->cell_background.blue = color->blue;
 555     }
 556   else
 557     {
 558       if (priv->cell_background_set)
 559         {
 560           priv->cell_background_set = FALSE;
 561           g_object_notify (G_OBJECT (cell), "cell-background-set");
 562         }
 563     }
 564 }
 565
 566 /**
 567  * gtk_cell_renderer_get_size:
 568  * @cell: a #GtkCellRenderer
 569  * @widget: the widget the renderer is rendering to
 570  * @cell_area: (allow-none): The area a cell will be allocated, or %NULL
 571  * @x_offset: (allow-none): location to return x offset of cell relative to @cell_area, or %NULL
 572  * @y_offset: (allow-none): location to return y offset of cell relative to @cell_area, or %NULL
 573  * @width: (allow-none): location to return width needed to render a cell, or %NULL
 574  * @height: (allow-none): location to return height needed to render a cell, or %NULL
 575  *
 576  * Obtains the width and height needed to render the cell. Used by view
 577  * widgets to determine the appropriate size for the cell_area passed to
 578  * gtk_cell_renderer_render().  If @cell_area is not %NULL, fills in the
 579  * x and y offsets (if set) of the cell relative to this location.
 580  *
 581  * Please note that the values set in @width and @height, as well as those
 582  * in @x_offset and @y_offset are inclusive of the xpad and ypad properties.
 583  *
 584  *
 585  * Deprecated: 3.0: Use gtk_cell_size_request_get_size() instead.
 586  **/
 587 void
 588 gtk_cell_renderer_get_size (GtkCellRenderer    *cell,
 589                             GtkWidget          *widget,
 590                             const GdkRectangle *cell_area,
 591                             gint               *x_offset,
 592                             gint               *y_offset,
 593                             gint               *width,
 594                             gint               *height)
 595 {
 596   GtkRequisition request;
 597
 598   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 599
 600   gtk_cell_size_request_get_size (GTK_CELL_SIZE_REQUEST (cell),
 601                                   widget, &request, NULL);
 602
 603   if (width)
 604     *width = request.width;
 605
 606   if (height)
 607     *height = request.height;
 608
 609   if (cell_area)
 610     _gtk_cell_renderer_calc_offset (cell, cell_area, gtk_widget_get_direction (widget),
 611                                     request.width, request.height, x_offset, y_offset);
 612 }
 613
 614 /**
 615  * gtk_cell_renderer_render:
 616  * @cell: a #GtkCellRenderer
 617  * @window: a #GdkDrawable to draw to
 618  * @widget: the widget owning @window
 619  * @background_area: entire cell area (including tree expanders and maybe
 620  *    padding on the sides)
 621  * @cell_area: area normally rendered by a cell renderer
 622  * @expose_area: area that actually needs updating
 623  * @flags: flags that affect rendering
 624  *
 625  * Invokes the virtual render function of the #GtkCellRenderer. The three
 626  * passed-in rectangles are areas of @window. Most renderers will draw within
 627  * @cell_area; the xalign, yalign, xpad, and ypad fields of the #GtkCellRenderer
 628  * should be honored with respect to @cell_area. @background_area includes the
 629  * blank space around the cell, and also the area containing the tree expander;
 630  * so the @background_area rectangles for all cells tile to cover the entire
 631  * @window.  @expose_area is a clip rectangle.
 632  **/
 633 void
 634 gtk_cell_renderer_render (GtkCellRenderer      *cell,
 635                           GdkWindow            *window,
 636                           GtkWidget            *widget,
 637                           const GdkRectangle   *background_area,
 638                           const GdkRectangle   *cell_area,
 639                           const GdkRectangle   *expose_area,
 640                           GtkCellRendererState  flags)
 641 {
 642   gboolean selected = FALSE;
 643   GtkCellRendererPrivate *priv = cell->priv;
 644   cairo_t *cr;
 645
 646   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 647   g_return_if_fail (GTK_CELL_RENDERER_GET_CLASS (cell)->render != NULL);
 648
 649   selected = (flags & GTK_CELL_RENDERER_SELECTED) == GTK_CELL_RENDERER_SELECTED;
 650
 651   cr = gdk_cairo_create (window);
 652   gdk_cairo_rectangle (cr, expose_area);
 653   cairo_clip (cr);
 654
 655   if (priv->cell_background_set && !selected)
 656     {
 657       gdk_cairo_rectangle (cr, background_area);
 658       gdk_cairo_set_source_color (cr, &priv->cell_background);
 659       cairo_fill (cr);
 660     }
 661
 662   GTK_CELL_RENDERER_GET_CLASS (cell)->render (cell,
 663                                               cr,
 664                                               widget,
 665                                               background_area,
 666                                               cell_area,
 667                                               flags);
 668
 669   cairo_destroy (cr);
 670 }
 671
 672 /**
 673  * gtk_cell_renderer_activate:
 674  * @cell: a #GtkCellRenderer
 675  * @event: a #GdkEvent
 676  * @widget: widget that received the event
 677  * @path: widget-dependent string representation of the event location;
 678  *    e.g. for #GtkTreeView, a string representation of #GtkTreePath
 679  * @background_area: background area as passed to gtk_cell_renderer_render()
 680  * @cell_area: cell area as passed to gtk_cell_renderer_render()
 681  * @flags: render flags
 682  *
 683  * Passes an activate event to the cell renderer for possible processing.
 684  * Some cell renderers may use events; for example, #GtkCellRendererToggle
 685  * toggles when it gets a mouse click.
 686  *
 687  * Return value: %TRUE if the event was consumed/handled
 688  **/
 689 gboolean
 690 gtk_cell_renderer_activate (GtkCellRenderer      *cell,
 691                             GdkEvent             *event,
 692                             GtkWidget            *widget,
 693                             const gchar          *path,
 694                             const GdkRectangle   *background_area,
 695                             const GdkRectangle   *cell_area,
 696                             GtkCellRendererState  flags)
 697 {
 698   GtkCellRendererPrivate *priv;
 699
 700   g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE);
 701
 702   priv = cell->priv;
 703
 704   if (priv->mode != GTK_CELL_RENDERER_MODE_ACTIVATABLE)
 705     return FALSE;
 706
 707   if (GTK_CELL_RENDERER_GET_CLASS (cell)->activate == NULL)
 708     return FALSE;
 709
 710   return GTK_CELL_RENDERER_GET_CLASS (cell)->activate (cell,
 711                                                        event,
 712                                                        widget,
 713                                                        path,
 714                                                        (GdkRectangle *) background_area,
 715                                                        (GdkRectangle *) cell_area,
 716                                                        flags);
 717 }
 718
 719 /**
 720  * gtk_cell_renderer_start_editing:
 721  * @cell: a #GtkCellRenderer
 722  * @event: a #GdkEvent
 723  * @widget: widget that received the event
 724  * @path: widget-dependent string representation of the event location;
 725  *    e.g. for #GtkTreeView, a string representation of #GtkTreePath
 726  * @background_area: background area as passed to gtk_cell_renderer_render()
 727  * @cell_area: cell area as passed to gtk_cell_renderer_render()
 728  * @flags: render flags
 729  *
 730  * Passes an activate event to the cell renderer for possible processing.
 731  *
 732  * Return value: (transfer full): A new #GtkCellEditable, or %NULL
 733  **/
 734 GtkCellEditable *
 735 gtk_cell_renderer_start_editing (GtkCellRenderer      *cell,
 736                                  GdkEvent             *event,
 737                                  GtkWidget            *widget,
 738                                  const gchar          *path,
 739                                  const GdkRectangle   *background_area,
 740                                  const GdkRectangle   *cell_area,
 741                                  GtkCellRendererState  flags)
 742
 743 {
 744   GtkCellRendererPrivate *priv;
 745   GtkCellEditable *editable;
 746
 747   g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), NULL);
 748
 749   priv = cell->priv;
 750
 751   if (priv->mode != GTK_CELL_RENDERER_MODE_EDITABLE)
 752     return NULL;
 753
 754   if (GTK_CELL_RENDERER_GET_CLASS (cell)->start_editing == NULL)
 755     return NULL;
 756
 757   editable = GTK_CELL_RENDERER_GET_CLASS (cell)->start_editing (cell,
 758                                                                 event,
 759                                                                 widget,
 760                                                                 path,
 761                                                                 (GdkRectangle *) background_area,
 762                                                                 (GdkRectangle *) cell_area,
 763                                                                 flags);
 764
 765   g_signal_emit (cell,
 766                  cell_renderer_signals[EDITING_STARTED], 0,
 767                  editable, path);
 768
 769   priv->editing = TRUE;
 770
 771   return editable;
 772 }
 773
 774 /**
 775  * gtk_cell_renderer_set_fixed_size:
 776  * @cell: A #GtkCellRenderer
 777  * @width: the width of the cell renderer, or -1
 778  * @height: the height of the cell renderer, or -1
 779  *
 780  * Sets the renderer size to be explicit, independent of the properties set.
 781  **/
 782 void
 783 gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell,
 784                                   gint             width,
 785                                   gint             height)
 786 {
 787   GtkCellRendererPrivate *priv;
 788
 789   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 790   g_return_if_fail (width >= -1 && height >= -1);
 791
 792   priv = cell->priv;
 793
 794   if ((width != priv->width) || (height != priv->height))
 795     {
 796       g_object_freeze_notify (G_OBJECT (cell));
 797
 798       if (width != priv->width)
 799         {
 800           priv->width = width;
 801           g_object_notify (G_OBJECT (cell), "width");
 802         }
 803
 804       if (height != priv->height)
 805         {
 806           priv->height = height;
 807           g_object_notify (G_OBJECT (cell), "height");
 808         }
 809
 810       g_object_thaw_notify (G_OBJECT (cell));
 811     }
 812 }
 813
 814 /**
 815  * gtk_cell_renderer_get_fixed_size:
 816  * @cell: A #GtkCellRenderer
 817  * @width: (allow-none): location to fill in with the fixed width of the cell, or %NULL
 818  * @height: (allow-none): location to fill in with the fixed height of the cell, or %NULL
 819  *
 820  * Fills in @width and @height with the appropriate size of @cell.
 821  **/
 822 void
 823 gtk_cell_renderer_get_fixed_size (GtkCellRenderer *cell,
 824                                   gint            *width,
 825                                   gint            *height)
 826 {
 827   GtkCellRendererPrivate *priv;
 828
 829   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 830
 831   priv = cell->priv;
 832
 833   if (width)
 834     *width = priv->width;
 835   if (height)
 836     *height = priv->height;
 837 }
 838
 839 /**
 840  * gtk_cell_renderer_set_alignment:
 841  * @cell: A #GtkCellRenderer
 842  * @xalign: the x alignment of the cell renderer
 843  * @yalign: the y alignment of the cell renderer
 844  *
 845  * Sets the renderer's alignment within its available space.
 846  *
 847  * Since: 2.18
 848  **/
 849 void
 850 gtk_cell_renderer_set_alignment (GtkCellRenderer *cell,
 851                                  gfloat           xalign,
 852                                  gfloat           yalign)
 853 {
 854   GtkCellRendererPrivate *priv;
 855
 856   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 857   g_return_if_fail (xalign >= 0.0 && xalign <= 1.0);
 858   g_return_if_fail (yalign >= 0.0 && yalign <= 1.0);
 859
 860   priv = cell->priv;
 861
 862   if ((xalign != priv->xalign) || (yalign != priv->yalign))
 863     {
 864       g_object_freeze_notify (G_OBJECT (cell));
 865
 866       if (xalign != priv->xalign)
 867         {
 868           priv->xalign = xalign;
 869           g_object_notify (G_OBJECT (cell), "xalign");
 870         }
 871
 872       if (yalign != priv->yalign)
 873         {
 874           priv->yalign = yalign;
 875           g_object_notify (G_OBJECT (cell), "yalign");
 876         }
 877
 878       g_object_thaw_notify (G_OBJECT (cell));
 879     }
 880 }
 881
 882 /**
 883  * gtk_cell_renderer_get_alignment:
 884  * @cell: A #GtkCellRenderer
 885  * @xalign: (allow-none): location to fill in with the x alignment of the cell, or %NULL
 886  * @yalign: (allow-none): location to fill in with the y alignment of the cell, or %NULL
 887  *
 888  * Fills in @xalign and @yalign with the appropriate values of @cell.
 889  *
 890  * Since: 2.18
 891  **/
 892 void
 893 gtk_cell_renderer_get_alignment (GtkCellRenderer *cell,
 894                                  gfloat          *xalign,
 895                                  gfloat          *yalign)
 896 {
 897   GtkCellRendererPrivate *priv;
 898
 899   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 900
 901   priv = cell->priv;
 902
 903   if (xalign)
 904     *xalign = priv->xalign;
 905   if (yalign)
 906     *yalign = priv->yalign;
 907 }
 908
 909 /**
 910  * gtk_cell_renderer_set_padding:
 911  * @cell: A #GtkCellRenderer
 912  * @xpad: the x padding of the cell renderer
 913  * @ypad: the y padding of the cell renderer
 914  *
 915  * Sets the renderer's padding.
 916  *
 917  * Since: 2.18
 918  **/
 919 void
 920 gtk_cell_renderer_set_padding (GtkCellRenderer *cell,
 921                                gint             xpad,
 922                                gint             ypad)
 923 {
 924   GtkCellRendererPrivate *priv;
 925
 926   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 927   g_return_if_fail (xpad >= 0 && xpad >= 0);
 928
 929   priv = cell->priv;
 930
 931   if ((xpad != priv->xpad) || (ypad != priv->ypad))
 932     {
 933       g_object_freeze_notify (G_OBJECT (cell));
 934
 935       if (xpad != priv->xpad)
 936         {
 937           priv->xpad = xpad;
 938           g_object_notify (G_OBJECT (cell), "xpad");
 939         }
 940
 941       if (ypad != priv->ypad)
 942         {
 943           priv->ypad = ypad;
 944           g_object_notify (G_OBJECT (cell), "ypad");
 945         }
 946
 947       g_object_thaw_notify (G_OBJECT (cell));
 948     }
 949 }
 950
 951 /**
 952  * gtk_cell_renderer_get_padding:
 953  * @cell: A #GtkCellRenderer
 954  * @xpad: (allow-none): location to fill in with the x padding of the cell, or %NULL
 955  * @ypad: (allow-none): location to fill in with the y padding of the cell, or %NULL
 956  *
 957  * Fills in @xpad and @ypad with the appropriate values of @cell.
 958  *
 959  * Since: 2.18
 960  **/
 961 void
 962 gtk_cell_renderer_get_padding (GtkCellRenderer *cell,
 963                                gint            *xpad,
 964                                gint            *ypad)
 965 {
 966   GtkCellRendererPrivate *priv;
 967
 968   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 969
 970   priv = cell->priv;
 971
 972   if (xpad)
 973     *xpad = priv->xpad;
 974   if (ypad)
 975     *ypad = priv->ypad;
 976 }
 977
 978 /**
 979  * gtk_cell_renderer_set_visible:
 980  * @cell: A #GtkCellRenderer
 981  * @visible: the visibility of the cell
 982  *
 983  * Sets the cell renderer's visibility.
 984  *
 985  * Since: 2.18
 986  **/
 987 void
 988 gtk_cell_renderer_set_visible (GtkCellRenderer *cell,
 989                                gboolean         visible)
 990 {
 991   GtkCellRendererPrivate *priv;
 992
 993   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
 994
 995   priv = cell->priv;
 996
 997   if (priv->visible != visible)
 998     {
 999       priv->visible = visible ? TRUE : FALSE;
1000       g_object_notify (G_OBJECT (cell), "visible");
1001     }
1002 }
1003
1004 /**
1005  * gtk_cell_renderer_get_visible:
1006  * @cell: A #GtkCellRenderer
1007  *
1008  * Returns the cell renderer's visibility.
1009  *
1010  * Returns: %TRUE if the cell renderer is visible
1011  *
1012  * Since: 2.18
1013  */
1014 gboolean
1015 gtk_cell_renderer_get_visible (GtkCellRenderer *cell)
1016 {
1017   g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE);
1018
1019   return cell->priv->visible;
1020 }
1021
1022 /**
1023  * gtk_cell_renderer_set_sensitive:
1024  * @cell: A #GtkCellRenderer
1025  * @sensitive: the sensitivity of the cell
1026  *
1027  * Sets the cell renderer's sensitivity.
1028  *
1029  * Since: 2.18
1030  **/
1031 void
1032 gtk_cell_renderer_set_sensitive (GtkCellRenderer *cell,
1033                                  gboolean         sensitive)
1034 {
1035   GtkCellRendererPrivate *priv;
1036
1037   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
1038
1039   priv = cell->priv;
1040
1041   if (priv->sensitive != sensitive)
1042     {
1043       priv->sensitive = sensitive ? TRUE : FALSE;
1044       g_object_notify (G_OBJECT (cell), "sensitive");
1045     }
1046 }
1047
1048 /**
1049  * gtk_cell_renderer_get_sensitive:
1050  * @cell: A #GtkCellRenderer
1051  *
1052  * Returns the cell renderer's sensitivity.
1053  *
1054  * Returns: %TRUE if the cell renderer is sensitive
1055  *
1056  * Since: 2.18
1057  */
1058 gboolean
1059 gtk_cell_renderer_get_sensitive (GtkCellRenderer *cell)
1060 {
1061   g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE);
1062
1063   return cell->priv->sensitive;
1064 }
1065
1066 /**
1067  * gtk_cell_renderer_stop_editing:
1068  * @cell: A #GtkCellRenderer
1069  * @canceled: %TRUE if the editing has been canceled
1070  *
1071  * Informs the cell renderer that the editing is stopped.
1072  * If @canceled is %TRUE, the cell renderer will emit the
1073  * #GtkCellRenderer::editing-canceled signal.
1074  *
1075  * This function should be called by cell renderer implementations
1076  * in response to the #GtkCellEditable::editing-done signal of
1077  * #GtkCellEditable.
1078  *
1079  * Since: 2.6
1080  **/
1081 void
1082 gtk_cell_renderer_stop_editing (GtkCellRenderer *cell,
1083                                 gboolean         canceled)
1084 {
1085   GtkCellRendererPrivate *priv;
1086
1087   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
1088
1089   priv = cell->priv;
1090
1091   if (priv->editing)
1092     {
1093       priv->editing = FALSE;
1094       if (canceled)
1095         g_signal_emit (cell, cell_renderer_signals[EDITING_CANCELED], 0);
1096     }
1097 }
1098
1099 static void
1100 gtk_cell_renderer_cell_size_request_init (GtkCellSizeRequestIface *iface)
1101 {
1102   iface->get_width     = gtk_cell_renderer_get_width;
1103   iface->get_height    = gtk_cell_renderer_get_height;
1104
1105   iface->get_width_for_height  = gtk_cell_renderer_get_width_for_height;
1106   iface->get_height_for_width  = gtk_cell_renderer_get_height_for_width;
1107 }
1108
1109 static void
1110 gtk_cell_renderer_get_desired_size (GtkCellSizeRequest   *cell,
1111                                     GtkWidget         *widget,
1112                                     GtkOrientation     orientation,
1113                                     gint              *minimum_size,
1114                                     gint              *natural_size)
1115 {
1116   GtkRequisition min_req;
1117
1118   /* Fallback on the old API to get the size. */
1119   if (GTK_CELL_RENDERER_GET_CLASS (cell)->get_size)
1120     GTK_CELL_RENDERER_GET_CLASS (cell)->get_size (GTK_CELL_RENDERER (cell), widget, NULL, NULL, NULL,
1121                                                   &min_req.width, &min_req.height);
1122   else
1123     {
1124       min_req.width = 0;
1125       min_req.height = 0;
1126     }
1127
1128   if (orientation == GTK_ORIENTATION_HORIZONTAL)
1129     {
1130       if (minimum_size)
1131         *minimum_size = min_req.width;
1132
1133       if (natural_size)
1134         *natural_size = min_req.width;
1135     }
1136   else
1137     {
1138       if (minimum_size)
1139         *minimum_size = min_req.height;
1140
1141       if (natural_size)
1142         *natural_size = min_req.height;
1143     }
1144 }
1145
1146 static void
1147 gtk_cell_renderer_get_width (GtkCellSizeRequest   *cell,
1148                              GtkWidget         *widget,
1149                              gint              *minimum_size,
1150                              gint              *natural_size)
1151 {
1152   gtk_cell_renderer_get_desired_size (cell, widget, GTK_ORIENTATION_HORIZONTAL,
1153                                       minimum_size, natural_size);
1154 }
1155
1156 static void
1157 gtk_cell_renderer_get_height (GtkCellSizeRequest   *cell,
1158                               GtkWidget         *widget,
1159                               gint              *minimum_size,
1160                               gint              *natural_size)
1161 {
1162   gtk_cell_renderer_get_desired_size (cell, widget, GTK_ORIENTATION_VERTICAL,
1163                                       minimum_size, natural_size);
1164 }
1165
1166
1167 static void
1168 gtk_cell_renderer_get_height_for_width (GtkCellSizeRequest *cell,
1169                                         GtkWidget       *widget,
1170                                         gint             width,
1171                                         gint            *minimum_height,
1172                                         gint            *natural_height)
1173 {
1174   /* Fall back on the height reported from ->get_size() */
1175   gtk_cell_size_request_get_height (cell, widget, minimum_height, natural_height);
1176 }
1177
1178 static void
1179 gtk_cell_renderer_get_width_for_height (GtkCellSizeRequest *cell,
1180                                         GtkWidget       *widget,
1181                                         gint             height,
1182                                         gint            *minimum_width,
1183                                         gint            *natural_width)
1184 {
1185   /* Fall back on the width reported from ->get_size() */
1186   gtk_cell_size_request_get_width (cell, widget, minimum_width, natural_width);
1187 }
1188
1189 /* An internal convenience function for some containers to peek at the
1190  * cell alignment in a target allocation (used to draw focus and align
1191  * cells in the icon view).
1192  *
1193  * Note this is only a trivial 'align * (allocation - request)' operation.
1194  */
1195 void
1196 _gtk_cell_renderer_calc_offset    (GtkCellRenderer      *cell,
1197                                    const GdkRectangle   *cell_area,
1198                                    GtkTextDirection      direction,
1199                                    gint                  width,
1200                                    gint                  height,
1201                                    gint                 *x_offset,
1202                                    gint                 *y_offset)
1203 {
1204   GtkCellRendererPrivate *priv;
1205
1206   g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
1207   g_return_if_fail (cell_area != NULL);
1208   g_return_if_fail (x_offset || y_offset);
1209
1210   priv = cell->priv;
1211
1212   if (x_offset)
1213     {
1214       *x_offset = (((direction == GTK_TEXT_DIR_RTL) ?
1215                     (1.0 - priv->xalign) : priv->xalign) *
1216                    (cell_area->width - width));
1217       *x_offset = MAX (*x_offset, 0);
1218     }
1219   if (y_offset)
1220     {
1221       *y_offset = (priv->yalign *
1222                    (cell_area->height - height));
1223       *y_offset = MAX (*y_offset, 0);
1224     }
1225 }