gtkcellrenderer.c 20 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19
/* gtkcellrenderer.c
 * Copyright (C) 2000  Red Hat, Inc. Jonathan Blandford
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

20
#include <config.h>
21
#include "gtkcellrenderer.h"
22
#include "gtkintl.h"
Federico Mena Quintero's avatar
Federico Mena Quintero committed
23
#include "gtkmarshalers.h"
24
#include "gtktreeprivate.h"
25 26 27

static void gtk_cell_renderer_init       (GtkCellRenderer      *cell);
static void gtk_cell_renderer_class_init (GtkCellRendererClass *class);
28 29 30
static void gtk_cell_renderer_get_property  (GObject              *object,
					     guint                 param_id,
					     GValue               *value,
Tim Janik's avatar
Tim Janik committed
31
					     GParamSpec           *pspec);
32 33 34
static void gtk_cell_renderer_set_property  (GObject              *object,
					     guint                 param_id,
					     const GValue         *value,
Tim Janik's avatar
Tim Janik committed
35
					     GParamSpec           *pspec);
36 37
static void set_cell_bg_color               (GtkCellRenderer      *cell,
					     GdkColor             *color);
38 39


40 41 42 43 44 45 46 47 48
#define GTK_CELL_RENDERER_GET_PRIVATE(obj) (G_TYPE_INSTANCE_GET_PRIVATE ((obj), GTK_TYPE_CELL_RENDERER, GtkCellRendererPrivate))

typedef struct _GtkCellRendererPrivate GtkCellRendererPrivate;
struct _GtkCellRendererPrivate
{
  GdkColor cell_background;
};


49 50
enum {
  PROP_ZERO,
51
  PROP_MODE,
52
  PROP_VISIBLE,
53 54 55
  PROP_XALIGN,
  PROP_YALIGN,
  PROP_XPAD,
56
  PROP_YPAD,
57 58
  PROP_WIDTH,
  PROP_HEIGHT,
59
  PROP_IS_EXPANDER,
60 61 62 63
  PROP_IS_EXPANDED,
  PROP_CELL_BACKGROUND,
  PROP_CELL_BACKGROUND_GDK,
  PROP_CELL_BACKGROUND_SET
64 65
};

Federico Mena Quintero's avatar
Federico Mena Quintero committed
66 67 68 69 70 71 72 73 74
/* Signal IDs */
enum {
  EDITING_CANCELED,
  LAST_SIGNAL
};

static guint cell_renderer_signals[LAST_SIGNAL] = { 0 };


Manish Singh's avatar
Manish Singh committed
75
GType
76 77
gtk_cell_renderer_get_type (void)
{
Manish Singh's avatar
Manish Singh committed
78
  static GType cell_type = 0;
79 80 81 82 83 84 85 86 87 88 89 90

  if (!cell_type)
    {
      static const GTypeInfo cell_info =
      {
        sizeof (GtkCellRendererClass),
	NULL,		/* base_init */
	NULL,		/* base_finalize */
        (GClassInitFunc) gtk_cell_renderer_class_init,
	NULL,		/* class_finalize */
	NULL,		/* class_data */
        sizeof (GtkCellRenderer),
Manish Singh's avatar
Manish Singh committed
91
	0,		/* n_preallocs */
92
        (GInstanceInitFunc) gtk_cell_renderer_init,
Manish Singh's avatar
Manish Singh committed
93
	NULL,		/* value_table */
94 95
      };

96 97
      cell_type = g_type_register_static (GTK_TYPE_OBJECT, "GtkCellRenderer", 
					  &cell_info, G_TYPE_FLAG_ABSTRACT);
98 99 100 101 102 103 104 105
    }

  return cell_type;
}

static void
gtk_cell_renderer_init (GtkCellRenderer *cell)
{
106
  cell->mode = GTK_CELL_RENDERER_MODE_INERT;
107
  cell->visible = TRUE;
108 109
  cell->width = -1;
  cell->height = -1;
110 111
  cell->xalign = 0.5;
  cell->yalign = 0.5;
112 113
  cell->xpad = 0;
  cell->ypad = 0;
114 115 116 117 118 119 120
}

static void
gtk_cell_renderer_class_init (GtkCellRendererClass *class)
{
  GObjectClass *object_class = G_OBJECT_CLASS (class);

121 122
  object_class->get_property = gtk_cell_renderer_get_property;
  object_class->set_property = gtk_cell_renderer_set_property;
123 124 125 126

  class->render = NULL;
  class->get_size = NULL;

Federico Mena Quintero's avatar
Federico Mena Quintero committed
127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147
  /**
   * GtkCellRenderer::editing-canceled:
   *
   * This signal gets emitted when the user cancels the process of editing a
   * cell.  For example, an editable cell renderer could be written to cancel
   * editing when the user presses Escape.
   *
   * See also: gtk_cell_renderer_editing_canceled()
   *
   * Since: 2.4
   */

  cell_renderer_signals[EDITING_CANCELED] =
    g_signal_new ("editing-canceled",
		  G_OBJECT_CLASS_TYPE (object_class),
		  G_SIGNAL_RUN_FIRST,
		  G_STRUCT_OFFSET (GtkCellRendererClass, editing_canceled),
		  NULL, NULL,
		  _gtk_marshal_VOID__VOID,
		  G_TYPE_NONE, 0);

148
  g_object_class_install_property (object_class,
149 150
				   PROP_MODE,
				   g_param_spec_enum ("mode",
151 152
						      P_("mode"),
						      P_("Editable mode of the CellRenderer"),
153 154 155 156
						      GTK_TYPE_CELL_RENDERER_MODE,
						      GTK_CELL_RENDERER_MODE_INERT,
						      G_PARAM_READABLE |
						      G_PARAM_WRITABLE));
157

158 159 160
  g_object_class_install_property (object_class,
				   PROP_VISIBLE,
				   g_param_spec_boolean ("visible",
161 162
							 P_("visible"),
							 P_("Display the cell"),
163 164 165
							 TRUE,
							 G_PARAM_READABLE |
							 G_PARAM_WRITABLE));
166

167 168 169
  g_object_class_install_property (object_class,
				   PROP_XALIGN,
				   g_param_spec_float ("xalign",
170 171
						       P_("xalign"),
						       P_("The x-align"),
172 173 174 175 176
						       0.0,
						       1.0,
						       0.0,
						       G_PARAM_READABLE |
						       G_PARAM_WRITABLE));
177

178 179 180
  g_object_class_install_property (object_class,
				   PROP_YALIGN,
				   g_param_spec_float ("yalign",
181 182
						       P_("yalign"),
						       P_("The y-align"),
183 184 185 186 187
						       0.0,
						       1.0,
						       0.5,
						       G_PARAM_READABLE |
						       G_PARAM_WRITABLE));
188

189 190 191
  g_object_class_install_property (object_class,
				   PROP_XPAD,
				   g_param_spec_uint ("xpad",
192 193
						      P_("xpad"),
						      P_("The xpad"),
194
						      0,
195
						      G_MAXUINT,
196 197 198
						      2,
						      G_PARAM_READABLE |
						      G_PARAM_WRITABLE));
199

200 201 202
  g_object_class_install_property (object_class,
				   PROP_YPAD,
				   g_param_spec_uint ("ypad",
203 204
						      P_("ypad"),
						      P_("The ypad"),
205
						      0,
206
						      G_MAXUINT,
207 208 209
						      2,
						      G_PARAM_READABLE |
						      G_PARAM_WRITABLE));
210 211 212 213

  g_object_class_install_property (object_class,
				   PROP_WIDTH,
				   g_param_spec_int ("width",
214 215
						     P_("width"),
						     P_("The fixed width"),
216
						     -1,
217
						     G_MAXINT,
218 219 220 221 222 223 224
						     -1,
						     G_PARAM_READABLE |
						     G_PARAM_WRITABLE));

  g_object_class_install_property (object_class,
				   PROP_HEIGHT,
				   g_param_spec_int ("height",
225 226
						     P_("height"),
						     P_("The fixed height"),
227
						     -1,
228
						     G_MAXINT,
229 230 231
						     -1,
						     G_PARAM_READABLE |
						     G_PARAM_WRITABLE));
232 233 234 235

  g_object_class_install_property (object_class,
				   PROP_IS_EXPANDER,
				   g_param_spec_boolean ("is_expander",
236 237
							 P_("Is Expander"),
							 P_("Row has children"),
238 239 240 241 242 243 244 245
							 FALSE,
							 G_PARAM_READABLE |
							 G_PARAM_WRITABLE));


  g_object_class_install_property (object_class,
				   PROP_IS_EXPANDED,
				   g_param_spec_boolean ("is_expanded",
246 247
							 P_("Is Expanded"),
							 P_("Row is an expander row, and is expanded"),
248 249 250
							 FALSE,
							 G_PARAM_READABLE |
							 G_PARAM_WRITABLE));
251 252 253 254

  g_object_class_install_property (object_class,
				   PROP_CELL_BACKGROUND,
				   g_param_spec_string ("cell_background",
255 256
							P_("Cell background color name"),
							P_("Cell background color as a string"),
257 258 259 260 261 262
							NULL,
							G_PARAM_WRITABLE));

  g_object_class_install_property (object_class,
				   PROP_CELL_BACKGROUND_GDK,
				   g_param_spec_boxed ("cell_background_gdk",
263 264
						       P_("Cell background color"),
						       P_("Cell background color as a GdkColor"),
265 266 267 268 269 270 271
						       GDK_TYPE_COLOR,
						       G_PARAM_READABLE | G_PARAM_WRITABLE));


#define ADD_SET_PROP(propname, propval, nick, blurb) g_object_class_install_property (object_class, propval, g_param_spec_boolean (propname, nick, blurb, FALSE, G_PARAM_READABLE | G_PARAM_WRITABLE))

  ADD_SET_PROP ("cell_background_set", PROP_CELL_BACKGROUND_SET,
272 273
                P_("Cell background set"),
                P_("Whether this tag affects the cell background color"));
274 275

  g_type_class_add_private (object_class, sizeof (GtkCellRendererPrivate));
276 277 278
}

static void
279 280 281
gtk_cell_renderer_get_property (GObject     *object,
				guint        param_id,
				GValue      *value,
Tim Janik's avatar
Tim Janik committed
282
				GParamSpec  *pspec)
283 284
{
  GtkCellRenderer *cell = GTK_CELL_RENDERER (object);
285
  GtkCellRendererPrivate *priv = GTK_CELL_RENDERER_GET_PRIVATE (object);
286 287 288

  switch (param_id)
    {
289 290
    case PROP_MODE:
      g_value_set_enum (value, cell->mode);
291
      break;
292 293 294
    case PROP_VISIBLE:
      g_value_set_boolean (value, cell->visible);
      break;
295 296 297 298 299 300 301
    case PROP_XALIGN:
      g_value_set_float (value, cell->xalign);
      break;
    case PROP_YALIGN:
      g_value_set_float (value, cell->yalign);
      break;
    case PROP_XPAD:
302
      g_value_set_uint (value, cell->xpad);
303 304
      break;
    case PROP_YPAD:
305
      g_value_set_uint (value, cell->ypad);
306
      break;
307 308 309 310 311 312
    case PROP_WIDTH:
      g_value_set_int (value, cell->width);
      break;
    case PROP_HEIGHT:
      g_value_set_int (value, cell->height);
      break;
313
    case PROP_IS_EXPANDER:
314
      g_value_set_boolean (value, cell->is_expander);
315 316
      break;
    case PROP_IS_EXPANDED:
317
      g_value_set_boolean (value, cell->is_expanded);
318
      break;
319 320 321 322
    case PROP_CELL_BACKGROUND_GDK:
      {
	GdkColor color;

323 324 325
	color.red = priv->cell_background.red;
	color.green = priv->cell_background.green;
	color.blue = priv->cell_background.blue;
326 327 328 329 330 331 332 333

	g_value_set_boxed (value, &color);
      }
      break;
    case PROP_CELL_BACKGROUND_SET:
      g_value_set_boolean (value, cell->cell_background_set);
      break;
    case PROP_CELL_BACKGROUND:
334
    default:
335
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
336 337 338 339 340 341
      break;
    }

}

static void
342 343 344
gtk_cell_renderer_set_property (GObject      *object,
				guint         param_id,
				const GValue *value,
Tim Janik's avatar
Tim Janik committed
345
				GParamSpec   *pspec)
346 347 348 349 350
{
  GtkCellRenderer *cell = GTK_CELL_RENDERER (object);

  switch (param_id)
    {
351 352
    case PROP_MODE:
      cell->mode = g_value_get_enum (value);
353
      break;
354 355 356
    case PROP_VISIBLE:
      cell->visible = g_value_get_boolean (value);
      break;
357 358 359 360 361 362 363
    case PROP_XALIGN:
      cell->xalign = g_value_get_float (value);
      break;
    case PROP_YALIGN:
      cell->yalign = g_value_get_float (value);
      break;
    case PROP_XPAD:
364
      cell->xpad = g_value_get_uint (value);
365 366
      break;
    case PROP_YPAD:
367
      cell->ypad = g_value_get_uint (value);
368
      break;
369 370 371 372 373 374
    case PROP_WIDTH:
      cell->width = g_value_get_int (value);
      break;
    case PROP_HEIGHT:
      cell->height = g_value_get_int (value);
      break;
375 376 377 378 379 380
    case PROP_IS_EXPANDER:
      cell->is_expander = g_value_get_boolean (value);
      break;
    case PROP_IS_EXPANDED:
      cell->is_expanded = g_value_get_boolean (value);
      break;
381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400
    case PROP_CELL_BACKGROUND:
      {
	GdkColor color;

	if (!g_value_get_string (value))
	  set_cell_bg_color (cell, NULL);
	else if (gdk_color_parse (g_value_get_string (value), &color))
	  set_cell_bg_color (cell, &color);
	else
	  g_warning ("Don't know color `%s'", g_value_get_string (value));

	g_object_notify (object, "cell_background_gdk");
      }
      break;
    case PROP_CELL_BACKGROUND_GDK:
      set_cell_bg_color (cell, g_value_get_boxed (value));
      break;
    case PROP_CELL_BACKGROUND_SET:
      cell->cell_background_set = g_value_get_boolean (value);
      break;
401
    default:
402
      G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
403 404 405 406
      break;
    }
}

407 408 409 410
static void
set_cell_bg_color (GtkCellRenderer *cell,
		   GdkColor        *color)
{
411
  GtkCellRendererPrivate *priv = GTK_CELL_RENDERER_GET_PRIVATE (cell);
412

413 414 415 416 417 418 419 420
  if (color)
    {
      if (!cell->cell_background_set)
        {
	  cell->cell_background_set = TRUE;
	  g_object_notify (G_OBJECT (cell), "cell_background_set");
	}

421 422 423
      priv->cell_background.red = color->red;
      priv->cell_background.green = color->green;
      priv->cell_background.blue = color->blue;
424 425 426 427 428 429 430 431 432 433 434
    }
  else
    {
      if (cell->cell_background_set)
        {
	  cell->cell_background_set = FALSE;
	  g_object_notify (G_OBJECT (cell), "cell_background_set");
	}
    }
}

435 436 437 438
/**
 * gtk_cell_renderer_get_size:
 * @cell: a #GtkCellRenderer
 * @widget: the widget the renderer is rendering to
439 440 441
 * @cell_area: The area a cell will be allocated, or %NULL
 * @x_offset: location to return x offset of cell relative to @cell_area, or %NULL
 * @y_offset: location to return y offset of cell relative to @cell_area, or %NULL
442 443
 * @width: location to return width needed to render a cell, or %NULL
 * @height: location to return height needed to render a cell, or %NULL
444 445 446 447
 *
 * Obtains the width and height needed to render the cell. Used by view widgets
 * to determine the appropriate size for the cell_area passed to
 * gtk_cell_renderer_render().  If @cell_area is not %NULL, fills in the x and y
448 449 450
 * offsets (if set) of the cell relative to this location.  Please note that the
 * values set in @width and @height, as well as those in @x_offset and @y_offset
 * are inclusive of the xpad and ypad properties.
451
 **/
452 453
void
gtk_cell_renderer_get_size (GtkCellRenderer *cell,
454 455 456 457 458 459
			    GtkWidget       *widget,
			    GdkRectangle    *cell_area,
			    gint            *x_offset,
			    gint            *y_offset,
			    gint            *width,
			    gint            *height)
460
{
461 462
  gint *real_width = width;
  gint *real_height = height;
463

464 465 466
  g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
  g_return_if_fail (GTK_CELL_RENDERER_GET_CLASS (cell)->get_size != NULL);

467
  if (width && cell->width != -1)
468
    {
469 470
      real_width = NULL;
      *width = cell->width;
471
    }
472
  if (height && cell->height != -1)
473
    {
474 475
      real_height = NULL;
      *height = cell->height;
476 477
    }

Manish Singh's avatar
Manish Singh committed
478 479 480 481 482 483 484
  GTK_CELL_RENDERER_GET_CLASS (cell)->get_size (cell,
						widget,
						cell_area,
						x_offset,
						y_offset,
						real_width,
						real_height);
485 486
}

487 488 489 490 491 492 493 494 495 496
/**
 * gtk_cell_renderer_render:
 * @cell: a #GtkCellRenderer
 * @window: a #GdkDrawable to draw to
 * @widget: the widget owning @window
 * @background_area: entire cell area (including tree expanders and maybe padding on the sides)
 * @cell_area: area normally rendered by a cell renderer
 * @expose_area: area that actually needs updating
 * @flags: flags that affect rendering
 *
497 498 499 500 501 502 503
 * Invokes the virtual render function of the #GtkCellRenderer. The three
 * passed-in rectangles are areas of @window. Most renderers will draw within
 * @cell_area; the xalign, yalign, xpad, and ypad fields of the #GtkCellRenderer
 * should be honored with respect to @cell_area. @background_area includes the
 * blank space around the cell, and also the area containing the tree expander;
 * so the @background_area rectangles for all cells tile to cover the entire
 * @window.  @expose_area is a clip rectangle.
504
 *
505
 **/
506
void
Havoc Pennington's avatar
Havoc Pennington committed
507 508 509 510 511 512 513
gtk_cell_renderer_render (GtkCellRenderer     *cell,
			  GdkWindow           *window,
			  GtkWidget           *widget,
			  GdkRectangle        *background_area,
			  GdkRectangle        *cell_area,
			  GdkRectangle        *expose_area,
			  GtkCellRendererState flags)
514
{
515
  gboolean selected = FALSE;
516
  GtkCellRendererPrivate *priv = GTK_CELL_RENDERER_GET_PRIVATE (cell);
517

518 519 520
  g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
  g_return_if_fail (GTK_CELL_RENDERER_GET_CLASS (cell)->render != NULL);

521 522 523 524 525 526 527
  selected = (flags & GTK_CELL_RENDERER_SELECTED) == GTK_CELL_RENDERER_SELECTED;

  if (cell->cell_background_set && !selected)
    {
      GdkColor color;
      GdkGC *gc;

528 529 530
      color.red = priv->cell_background.red;
      color.green = priv->cell_background.green;
      color.blue = priv->cell_background.blue;
531 532 533 534 535 536

      gc = gdk_gc_new (window);
      gdk_gc_set_rgb_fg_color (gc, &color);
      gdk_draw_rectangle (window, gc, TRUE,
                          background_area->x, background_area->y,
                          background_area->width, background_area->height);
Manish Singh's avatar
Manish Singh committed
537
      g_object_unref (gc);
538 539
    }

540 541 542 543 544 545 546 547 548
  GTK_CELL_RENDERER_GET_CLASS (cell)->render (cell,
					      window,
					      widget,
					      background_area,
					      cell_area,
					      expose_area,
					      flags);
}

549
/**
550
 * gtk_cell_renderer_activate:
551 552 553 554
 * @cell: a #GtkCellRenderer
 * @event: a #GdkEvent
 * @widget: widget that received the event
 * @path: widget-dependent string representation of the event location; e.g. for #GtkTreeView, a string representation of #GtkTreePath
555 556
 * @background_area: background area as passed to @gtk_cell_renderer_render
 * @cell_area: cell area as passed to @gtk_cell_renderer_render
557
 * @flags: render flags
558
 *
559 560 561
 * Passes an activate event to the cell renderer for possible processing.  Some
 * cell renderers may use events; for example, #GtkCellRendererToggle toggles
 * when it gets a mouse click.
562
 *
563 564
 * Return value: %TRUE if the event was consumed/handled
 **/
565
gboolean
566 567 568
gtk_cell_renderer_activate (GtkCellRenderer      *cell,
			    GdkEvent             *event,
			    GtkWidget            *widget,
569
			    const gchar          *path,
570 571 572
			    GdkRectangle         *background_area,
			    GdkRectangle         *cell_area,
			    GtkCellRendererState  flags)
573 574
{
  g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), FALSE);
575

576
  if (cell->mode != GTK_CELL_RENDERER_MODE_ACTIVATABLE)
577 578
    return FALSE;

579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596
  if (GTK_CELL_RENDERER_GET_CLASS (cell)->activate == NULL)
    return FALSE;

  return GTK_CELL_RENDERER_GET_CLASS (cell)->activate (cell,
						       event,
						       widget,
						       path,
						       background_area,
						       cell_area,
						       flags);
}

/**
 * gtk_cell_renderer_start_editing:
 * @cell: a #GtkCellRenderer
 * @event: a #GdkEvent
 * @widget: widget that received the event
 * @path: widget-dependent string representation of the event location; e.g. for #GtkTreeView, a string representation of #GtkTreePath
597 598
 * @background_area: background area as passed to @gtk_cell_renderer_render
 * @cell_area: cell area as passed to @gtk_cell_renderer_render
599 600 601 602 603 604 605 606 607 608
 * @flags: render flags
 * 
 * Passes an activate event to the cell renderer for possible processing.
 * 
 * Return value: A new #GtkCellEditable, or %NULL
 **/
GtkCellEditable *
gtk_cell_renderer_start_editing (GtkCellRenderer      *cell,
				 GdkEvent             *event,
				 GtkWidget            *widget,
609
				 const gchar          *path,
610 611 612 613 614 615 616
				 GdkRectangle         *background_area,
				 GdkRectangle         *cell_area,
				 GtkCellRendererState  flags)

{
  g_return_val_if_fail (GTK_IS_CELL_RENDERER (cell), NULL);

617
  if (cell->mode != GTK_CELL_RENDERER_MODE_EDITABLE)
618 619 620 621 622 623 624 625 626 627 628 629 630
    return NULL;

  if (GTK_CELL_RENDERER_GET_CLASS (cell)->start_editing == NULL)
    return NULL;

  
  return GTK_CELL_RENDERER_GET_CLASS (cell)->start_editing (cell,
							    event,
							    widget,
							    path,
							    background_area,
							    cell_area,
							    flags);
631 632
}

633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648
/**
 * gtk_cell_renderer_set_fixed_size:
 * @cell: A #GtkCellRenderer
 * @width: the width of the cell renderer, or -1
 * @height: the height of the cell renderer, or -1
 * 
 * Sets the renderer size to be explicit, independent of the properties set.
 **/
void
gtk_cell_renderer_set_fixed_size (GtkCellRenderer *cell,
				  gint             width,
				  gint             height)
{
  g_return_if_fail (GTK_IS_CELL_RENDERER (cell));
  g_return_if_fail (width >= -1 && height >= -1);

Hans Breuer's avatar
Hans Breuer committed
649
  if ((width != cell->width) || (height != cell->height))
650
    {
Hans Breuer's avatar
Hans Breuer committed
651
      g_object_freeze_notify (G_OBJECT (cell));
652

Hans Breuer's avatar
Hans Breuer committed
653 654 655 656 657 658 659 660 661 662 663 664 665
      if (width != cell->width)
        {
          cell->width = width;
          g_object_notify (G_OBJECT (cell), "width");
        }

      if (height != cell->height)
        {
          cell->height = height;
          g_object_notify (G_OBJECT (cell), "height");
        }

      g_object_thaw_notify (G_OBJECT (cell));
666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688
    }
}

/**
 * gtk_cell_renderer_get_fixed_size:
 * @cell: A #GtkCellRenderer
 * @width: location to fill in with the fixed width of the widget, or %NULL
 * @height: location to fill in with the fixed height of the widget, or %NULL
 * 
 * Fills in @width and @height with the appropriate size of @cell.
 **/
void
gtk_cell_renderer_get_fixed_size (GtkCellRenderer *cell,
				  gint            *width,
				  gint            *height)
{
  g_return_if_fail (GTK_IS_CELL_RENDERER (cell));

  if (width)
    (* width) = cell->width;
  if (height)
    (* height) = cell->height;
}
Federico Mena Quintero's avatar
Federico Mena Quintero committed
689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707

/**
 * gtk_cell_renderer_editing_canceled:
 * @cell: A #GtkCellRenderer
 * 
 * Causes the cell renderer to emit the "editing-canceled" signal.  This
 * function is for use only by implementations of cell renderers that need to
 * notify the client program that an editing process was canceled and the
 * changes were not committed.
 *
 * Since: 2.4
 **/
void
gtk_cell_renderer_editing_canceled (GtkCellRenderer *cell)
{
  g_return_if_fail (GTK_IS_CELL_RENDERER (cell));

  g_signal_emit (cell, cell_renderer_signals[EDITING_CANCELED], 0);
}