1 /* gtkcellrenderertext.c
2 * Copyright (C) 2000 Red Hat, Inc., Jonathan Blandford <jrb@redhat.com>
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.
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.
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.
21 #include "gtkcellrenderertext.h"
22 #include "gtkeditable.h"
24 #include "gtkmarshalers.h"
26 #include "gtktreeprivate.h"
28 static void gtk_cell_renderer_text_init (GtkCellRendererText *celltext);
29 static void gtk_cell_renderer_text_class_init (GtkCellRendererTextClass *class);
30 static void gtk_cell_renderer_text_finalize (GObject *object);
32 static void gtk_cell_renderer_text_get_property (GObject *object,
36 static void gtk_cell_renderer_text_set_property (GObject *object,
40 static void gtk_cell_renderer_text_get_size (GtkCellRenderer *cell,
42 GdkRectangle *cell_area,
47 static void gtk_cell_renderer_text_render (GtkCellRenderer *cell,
50 GdkRectangle *background_area,
51 GdkRectangle *cell_area,
52 GdkRectangle *expose_area,
53 GtkCellRendererState flags);
55 static GtkCellEditable *gtk_cell_renderer_text_start_editing (GtkCellRenderer *cell,
59 GdkRectangle *background_area,
60 GdkRectangle *cell_area,
61 GtkCellRendererState flags);
95 /* Whether-a-style-arg-is-set args */
106 PROP_STRIKETHROUGH_SET,
111 static gpointer parent_class;
112 static guint text_cell_renderer_signals [LAST_SIGNAL];
114 #define GTK_CELL_RENDERER_TEXT_PATH "gtk-cell-renderer-text-path"
117 gtk_cell_renderer_text_get_type (void)
119 static GType cell_text_type = 0;
123 static const GTypeInfo cell_text_info =
125 sizeof (GtkCellRendererTextClass),
126 NULL, /* base_init */
127 NULL, /* base_finalize */
128 (GClassInitFunc) gtk_cell_renderer_text_class_init,
129 NULL, /* class_finalize */
130 NULL, /* class_data */
131 sizeof (GtkCellRendererText),
133 (GInstanceInitFunc) gtk_cell_renderer_text_init,
137 g_type_register_static (GTK_TYPE_CELL_RENDERER, "GtkCellRendererText",
141 return cell_text_type;
145 gtk_cell_renderer_text_init (GtkCellRendererText *celltext)
147 GTK_CELL_RENDERER (celltext)->xalign = 0.0;
148 GTK_CELL_RENDERER (celltext)->yalign = 0.5;
149 GTK_CELL_RENDERER (celltext)->xpad = 2;
150 GTK_CELL_RENDERER (celltext)->ypad = 2;
151 celltext->fixed_height_rows = -1;
152 celltext->font = pango_font_description_new ();
156 gtk_cell_renderer_text_class_init (GtkCellRendererTextClass *class)
158 GObjectClass *object_class = G_OBJECT_CLASS (class);
159 GtkCellRendererClass *cell_class = GTK_CELL_RENDERER_CLASS (class);
161 parent_class = g_type_class_peek_parent (class);
163 object_class->finalize = gtk_cell_renderer_text_finalize;
165 object_class->get_property = gtk_cell_renderer_text_get_property;
166 object_class->set_property = gtk_cell_renderer_text_set_property;
168 cell_class->get_size = gtk_cell_renderer_text_get_size;
169 cell_class->render = gtk_cell_renderer_text_render;
170 cell_class->start_editing = gtk_cell_renderer_text_start_editing;
172 g_object_class_install_property (object_class,
174 g_param_spec_string ("text",
180 g_object_class_install_property (object_class,
182 g_param_spec_string ("markup",
184 _("Marked up text to render"),
188 g_object_class_install_property (object_class,
190 g_param_spec_boxed ("attributes",
192 _("A list of style attributes to apply to the text of the renderer"),
193 PANGO_TYPE_ATTR_LIST,
196 g_object_class_install_property (object_class,
198 g_param_spec_string ("background",
199 _("Background color name"),
200 _("Background color as a string"),
204 g_object_class_install_property (object_class,
206 g_param_spec_boxed ("background_gdk",
207 _("Background color"),
208 _("Background color as a GdkColor"),
210 G_PARAM_READABLE | G_PARAM_WRITABLE));
212 g_object_class_install_property (object_class,
214 g_param_spec_string ("foreground",
215 _("Foreground color name"),
216 _("Foreground color as a string"),
220 g_object_class_install_property (object_class,
222 g_param_spec_boxed ("foreground_gdk",
223 _("Foreground color"),
224 _("Foreground color as a GdkColor"),
226 G_PARAM_READABLE | G_PARAM_WRITABLE));
229 g_object_class_install_property (object_class,
231 g_param_spec_boolean ("editable",
233 _("Whether the text can be modified by the user"),
235 G_PARAM_READABLE | G_PARAM_WRITABLE));
237 g_object_class_install_property (object_class,
239 g_param_spec_string ("font",
241 _("Font description as a string"),
243 G_PARAM_READABLE | G_PARAM_WRITABLE));
245 g_object_class_install_property (object_class,
247 g_param_spec_boxed ("font_desc",
249 _("Font description as a PangoFontDescription struct"),
250 PANGO_TYPE_FONT_DESCRIPTION,
251 G_PARAM_READABLE | G_PARAM_WRITABLE));
254 g_object_class_install_property (object_class,
256 g_param_spec_string ("family",
258 _("Name of the font family, e.g. Sans, Helvetica, Times, Monospace"),
260 G_PARAM_READABLE | G_PARAM_WRITABLE));
262 g_object_class_install_property (object_class,
264 g_param_spec_enum ("style",
269 G_PARAM_READABLE | G_PARAM_WRITABLE));
271 g_object_class_install_property (object_class,
273 g_param_spec_enum ("variant",
277 PANGO_VARIANT_NORMAL,
278 G_PARAM_READABLE | G_PARAM_WRITABLE));
280 g_object_class_install_property (object_class,
282 g_param_spec_int ("weight",
288 G_PARAM_READABLE | G_PARAM_WRITABLE));
290 g_object_class_install_property (object_class,
292 g_param_spec_enum ("stretch",
296 PANGO_STRETCH_NORMAL,
297 G_PARAM_READABLE | G_PARAM_WRITABLE));
299 g_object_class_install_property (object_class,
301 g_param_spec_int ("size",
307 G_PARAM_READABLE | G_PARAM_WRITABLE));
309 g_object_class_install_property (object_class,
311 g_param_spec_double ("size_points",
313 _("Font size in points"),
317 G_PARAM_READABLE | G_PARAM_WRITABLE));
319 g_object_class_install_property (object_class,
321 g_param_spec_double ("scale",
323 _("Font scaling factor"),
327 G_PARAM_READABLE | G_PARAM_WRITABLE));
329 g_object_class_install_property (object_class,
331 g_param_spec_int ("rise",
333 _("Offset of text above the baseline (below the baseline if rise is negative)"),
337 G_PARAM_READABLE | G_PARAM_WRITABLE));
340 g_object_class_install_property (object_class,
342 g_param_spec_boolean ("strikethrough",
344 _("Whether to strike through the text"),
346 G_PARAM_READABLE | G_PARAM_WRITABLE));
348 g_object_class_install_property (object_class,
350 g_param_spec_enum ("underline",
352 _("Style of underline for this text"),
353 PANGO_TYPE_UNDERLINE,
354 PANGO_UNDERLINE_NONE,
355 G_PARAM_READABLE | G_PARAM_WRITABLE));
357 /* Style props are set or not */
359 #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))
361 ADD_SET_PROP ("background_set", PROP_BACKGROUND_SET,
363 _("Whether this tag affects the background color"));
365 ADD_SET_PROP ("foreground_set", PROP_FOREGROUND_SET,
367 _("Whether this tag affects the foreground color"));
369 ADD_SET_PROP ("editable_set", PROP_EDITABLE_SET,
370 _("Editability set"),
371 _("Whether this tag affects text editability"));
373 ADD_SET_PROP ("family_set", PROP_FAMILY_SET,
374 _("Font family set"),
375 _("Whether this tag affects the font family"));
377 ADD_SET_PROP ("style_set", PROP_STYLE_SET,
379 _("Whether this tag affects the font style"));
381 ADD_SET_PROP ("variant_set", PROP_VARIANT_SET,
382 _("Font variant set"),
383 _("Whether this tag affects the font variant"));
385 ADD_SET_PROP ("weight_set", PROP_WEIGHT_SET,
386 _("Font weight set"),
387 _("Whether this tag affects the font weight"));
389 ADD_SET_PROP ("stretch_set", PROP_STRETCH_SET,
390 _("Font stretch set"),
391 _("Whether this tag affects the font stretch"));
393 ADD_SET_PROP ("size_set", PROP_SIZE_SET,
395 _("Whether this tag affects the font size"));
397 ADD_SET_PROP ("scale_set", PROP_SCALE_SET,
399 _("Whether this tag scales the font size by a factor"));
401 ADD_SET_PROP ("rise_set", PROP_RISE_SET,
403 _("Whether this tag affects the rise"));
405 ADD_SET_PROP ("strikethrough_set", PROP_STRIKETHROUGH_SET,
406 _("Strikethrough set"),
407 _("Whether this tag affects strikethrough"));
409 ADD_SET_PROP ("underline_set", PROP_UNDERLINE_SET,
411 _("Whether this tag affects underlining"));
413 text_cell_renderer_signals [EDITED] =
414 g_signal_new ("edited",
415 G_OBJECT_CLASS_TYPE (object_class),
417 G_STRUCT_OFFSET (GtkCellRendererTextClass, edited),
419 _gtk_marshal_VOID__STRING_STRING,
427 gtk_cell_renderer_text_finalize (GObject *object)
429 GtkCellRendererText *celltext = GTK_CELL_RENDERER_TEXT (object);
431 pango_font_description_free (celltext->font);
434 g_free (celltext->text);
436 if (celltext->extra_attrs)
437 pango_attr_list_unref (celltext->extra_attrs);
439 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
443 get_property_font_set_mask (guint prop_id)
447 case PROP_FAMILY_SET:
448 return PANGO_FONT_MASK_FAMILY;
450 return PANGO_FONT_MASK_STYLE;
451 case PROP_VARIANT_SET:
452 return PANGO_FONT_MASK_VARIANT;
453 case PROP_WEIGHT_SET:
454 return PANGO_FONT_MASK_WEIGHT;
455 case PROP_STRETCH_SET:
456 return PANGO_FONT_MASK_STRETCH;
458 return PANGO_FONT_MASK_SIZE;
465 gtk_cell_renderer_text_get_property (GObject *object,
470 GtkCellRendererText *celltext = GTK_CELL_RENDERER_TEXT (object);
475 g_value_set_string (value, celltext->text);
478 case PROP_ATTRIBUTES:
479 g_value_set_boxed (value, celltext->extra_attrs);
482 case PROP_BACKGROUND_GDK:
486 color.red = celltext->background.red;
487 color.green = celltext->background.green;
488 color.blue = celltext->background.blue;
490 g_value_set_boxed (value, &color);
494 case PROP_FOREGROUND_GDK:
498 color.red = celltext->foreground.red;
499 color.green = celltext->foreground.green;
500 color.blue = celltext->foreground.blue;
502 g_value_set_boxed (value, &color);
508 /* FIXME GValue imposes a totally gratuitous string copy
509 * here, we could just hand off string ownership
511 gchar *str = pango_font_description_to_string (celltext->font);
512 g_value_set_string (value, str);
518 g_value_set_boxed (value, celltext->font);
522 g_value_set_string (value, pango_font_description_get_family (celltext->font));
526 g_value_set_enum (value, pango_font_description_get_style (celltext->font));
530 g_value_set_enum (value, pango_font_description_get_variant (celltext->font));
534 g_value_set_int (value, pango_font_description_get_weight (celltext->font));
538 g_value_set_enum (value, pango_font_description_get_stretch (celltext->font));
542 g_value_set_int (value, pango_font_description_get_size (celltext->font));
545 case PROP_SIZE_POINTS:
546 g_value_set_double (value, ((double)pango_font_description_get_size (celltext->font)) / (double)PANGO_SCALE);
550 g_value_set_double (value, celltext->font_scale);
554 g_value_set_boolean (value, celltext->editable);
557 case PROP_STRIKETHROUGH:
558 g_value_set_boolean (value, celltext->strikethrough);
562 g_value_set_enum (value, celltext->underline_style);
566 g_value_set_int (value, celltext->rise);
569 case PROP_BACKGROUND_SET:
570 g_value_set_boolean (value, celltext->background_set);
573 case PROP_FOREGROUND_SET:
574 g_value_set_boolean (value, celltext->foreground_set);
577 case PROP_FAMILY_SET:
579 case PROP_VARIANT_SET:
580 case PROP_WEIGHT_SET:
581 case PROP_STRETCH_SET:
584 PangoFontMask mask = get_property_font_set_mask (param_id);
585 g_value_set_boolean (value, (pango_font_description_get_set_fields (celltext->font) & mask) != 0);
591 g_value_set_boolean (value, celltext->scale_set);
594 case PROP_EDITABLE_SET:
595 g_value_set_boolean (value, celltext->editable_set);
598 case PROP_STRIKETHROUGH_SET:
599 g_value_set_boolean (value, celltext->strikethrough_set);
602 case PROP_UNDERLINE_SET:
603 g_value_set_boolean (value, celltext->underline_set);
607 g_value_set_boolean (value, celltext->rise_set);
610 case PROP_BACKGROUND:
611 case PROP_FOREGROUND:
614 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
621 set_bg_color (GtkCellRendererText *celltext,
626 if (!celltext->background_set)
628 celltext->background_set = TRUE;
629 g_object_notify (G_OBJECT (celltext), "background_set");
632 celltext->background.red = color->red;
633 celltext->background.green = color->green;
634 celltext->background.blue = color->blue;
638 if (celltext->background_set)
640 celltext->background_set = FALSE;
641 g_object_notify (G_OBJECT (celltext), "background_set");
648 set_fg_color (GtkCellRendererText *celltext,
653 if (!celltext->foreground_set)
655 celltext->foreground_set = TRUE;
656 g_object_notify (G_OBJECT (celltext), "foreground_set");
659 celltext->foreground.red = color->red;
660 celltext->foreground.green = color->green;
661 celltext->foreground.blue = color->blue;
665 if (celltext->foreground_set)
667 celltext->foreground_set = FALSE;
668 g_object_notify (G_OBJECT (celltext), "foreground_set");
674 set_font_desc_fields (PangoFontDescription *desc,
675 PangoFontMask to_set)
677 PangoFontMask changed_mask = 0;
679 if (to_set & PANGO_FONT_MASK_FAMILY)
681 const char *family = pango_font_description_get_family (desc);
685 changed_mask |= PANGO_FONT_MASK_FAMILY;
688 pango_font_description_set_family (desc, family);
690 if (to_set & PANGO_FONT_MASK_STYLE)
691 pango_font_description_set_style (desc, pango_font_description_get_style (desc));
692 if (to_set & PANGO_FONT_MASK_VARIANT)
693 pango_font_description_set_variant (desc, pango_font_description_get_variant (desc));
694 if (to_set & PANGO_FONT_MASK_WEIGHT)
695 pango_font_description_set_weight (desc, pango_font_description_get_weight (desc));
696 if (to_set & PANGO_FONT_MASK_STRETCH)
697 pango_font_description_set_stretch (desc, pango_font_description_get_stretch (desc));
698 if (to_set & PANGO_FONT_MASK_SIZE)
700 gint size = pango_font_description_get_size (desc);
703 size = 10 * PANGO_SCALE;
704 changed_mask |= PANGO_FONT_MASK_SIZE;
707 pango_font_description_set_size (desc, size);
714 notify_set_changed (GObject *object,
715 PangoFontMask changed_mask)
717 if (changed_mask & PANGO_FONT_MASK_FAMILY)
718 g_object_notify (object, "family_set");
719 if (changed_mask & PANGO_FONT_MASK_STYLE)
720 g_object_notify (object, "style_set");
721 if (changed_mask & PANGO_FONT_MASK_VARIANT)
722 g_object_notify (object, "variant_set");
723 if (changed_mask & PANGO_FONT_MASK_WEIGHT)
724 g_object_notify (object, "weight_set");
725 if (changed_mask & PANGO_FONT_MASK_STRETCH)
726 g_object_notify (object, "stretch_set");
727 if (changed_mask & PANGO_FONT_MASK_SIZE)
728 g_object_notify (object, "size_set");
732 notify_fields_changed (GObject *object,
733 PangoFontMask changed_mask)
735 if (changed_mask & PANGO_FONT_MASK_FAMILY)
736 g_object_notify (object, "family");
737 if (changed_mask & PANGO_FONT_MASK_STYLE)
738 g_object_notify (object, "style");
739 if (changed_mask & PANGO_FONT_MASK_VARIANT)
740 g_object_notify (object, "variant");
741 if (changed_mask & PANGO_FONT_MASK_WEIGHT)
742 g_object_notify (object, "weight");
743 if (changed_mask & PANGO_FONT_MASK_STRETCH)
744 g_object_notify (object, "stretch");
745 if (changed_mask & PANGO_FONT_MASK_SIZE)
746 g_object_notify (object, "size");
750 set_font_description (GtkCellRendererText *celltext,
751 PangoFontDescription *font_desc)
753 GObject *object = G_OBJECT (celltext);
754 PangoFontDescription *new_font_desc;
755 PangoFontMask old_mask, new_mask, changed_mask, set_changed_mask;
758 new_font_desc = pango_font_description_copy (font_desc);
760 new_font_desc = pango_font_description_new ();
762 old_mask = pango_font_description_get_set_fields (celltext->font);
763 new_mask = pango_font_description_get_set_fields (new_font_desc);
765 changed_mask = old_mask | new_mask;
766 set_changed_mask = old_mask ^ new_mask;
768 pango_font_description_free (celltext->font);
769 celltext->font = new_font_desc;
771 g_object_freeze_notify (object);
773 g_object_notify (object, "font_desc");
774 g_object_notify (object, "font");
776 if (changed_mask & PANGO_FONT_MASK_FAMILY)
777 g_object_notify (object, "family");
778 if (changed_mask & PANGO_FONT_MASK_STYLE)
779 g_object_notify (object, "style");
780 if (changed_mask & PANGO_FONT_MASK_VARIANT)
781 g_object_notify (object, "variant");
782 if (changed_mask & PANGO_FONT_MASK_WEIGHT)
783 g_object_notify (object, "weight");
784 if (changed_mask & PANGO_FONT_MASK_STRETCH)
785 g_object_notify (object, "stretch");
786 if (changed_mask & PANGO_FONT_MASK_SIZE)
788 g_object_notify (object, "size");
789 g_object_notify (object, "size_points");
792 notify_set_changed (object, set_changed_mask);
794 g_object_thaw_notify (object);
798 gtk_cell_renderer_text_set_property (GObject *object,
803 GtkCellRendererText *celltext = GTK_CELL_RENDERER_TEXT (object);
809 g_free (celltext->text);
810 celltext->text = g_strdup (g_value_get_string (value));
811 g_object_notify (object, "text");
814 case PROP_ATTRIBUTES:
815 if (celltext->extra_attrs)
816 pango_attr_list_unref (celltext->extra_attrs);
818 celltext->extra_attrs = g_value_get_boxed (value);
819 if (celltext->extra_attrs)
820 pango_attr_list_ref (celltext->extra_attrs);
826 GError *error = NULL;
827 PangoAttrList *attrs = NULL;
830 g_free (celltext->text);
832 if (celltext->extra_attrs)
833 pango_attr_list_unref (celltext->extra_attrs);
835 str = g_value_get_string (value);
836 if (str && !pango_parse_markup (str,
844 g_warning ("Failed to set cell text from markup due to error parsing markup: %s",
846 g_error_free (error);
850 celltext->text = text;
851 celltext->extra_attrs = attrs;
855 case PROP_BACKGROUND:
859 if (!g_value_get_string (value))
860 set_bg_color (celltext, NULL); /* reset to backgrounmd_set to FALSE */
861 else if (gdk_color_parse (g_value_get_string (value), &color))
862 set_bg_color (celltext, &color);
864 g_warning ("Don't know color `%s'", g_value_get_string (value));
866 g_object_notify (object, "background_gdk");
870 case PROP_FOREGROUND:
874 if (!g_value_get_string (value))
875 set_fg_color (celltext, NULL); /* reset to foreground_set to FALSE */
876 else if (gdk_color_parse (g_value_get_string (value), &color))
877 set_fg_color (celltext, &color);
879 g_warning ("Don't know color `%s'", g_value_get_string (value));
881 g_object_notify (object, "foreground_gdk");
885 case PROP_BACKGROUND_GDK:
886 /* This notifies the GObject itself. */
887 set_bg_color (celltext, g_value_get_boxed (value));
890 case PROP_FOREGROUND_GDK:
891 /* This notifies the GObject itself. */
892 set_fg_color (celltext, g_value_get_boxed (value));
897 PangoFontDescription *font_desc = NULL;
900 name = g_value_get_string (value);
903 font_desc = pango_font_description_from_string (name);
905 set_font_description (celltext, font_desc);
907 if (celltext->fixed_height_rows != -1)
908 celltext->calc_fixed_height = TRUE;
913 set_font_description (celltext, g_value_get_boxed (value));
915 if (celltext->fixed_height_rows != -1)
916 celltext->calc_fixed_height = TRUE;
925 case PROP_SIZE_POINTS:
927 PangoFontMask old_set_mask = pango_font_description_get_set_fields (celltext->font);
932 pango_font_description_set_family (celltext->font,
933 g_value_get_string (value));
936 pango_font_description_set_style (celltext->font,
937 g_value_get_enum (value));
940 pango_font_description_set_variant (celltext->font,
941 g_value_get_enum (value));
944 pango_font_description_set_weight (celltext->font,
945 g_value_get_int (value));
948 pango_font_description_set_stretch (celltext->font,
949 g_value_get_enum (value));
952 pango_font_description_set_size (celltext->font,
953 g_value_get_int (value));
954 g_object_notify (object, "size_points");
956 case PROP_SIZE_POINTS:
957 pango_font_description_set_size (celltext->font,
958 g_value_get_double (value) * PANGO_SCALE);
959 g_object_notify (object, "size");
963 if (celltext->fixed_height_rows != -1)
964 celltext->calc_fixed_height = TRUE;
966 notify_set_changed (object, old_set_mask & pango_font_description_get_set_fields (celltext->font));
967 g_object_notify (object, "font_desc");
968 g_object_notify (object, "font");
974 celltext->font_scale = g_value_get_double (value);
975 celltext->scale_set = TRUE;
976 if (celltext->fixed_height_rows != -1)
977 celltext->calc_fixed_height = TRUE;
978 g_object_notify (object, "scale_set");
982 celltext->editable = g_value_get_boolean (value);
983 celltext->editable_set = TRUE;
984 if (celltext->editable)
985 GTK_CELL_RENDERER (celltext)->mode = GTK_CELL_RENDERER_MODE_EDITABLE;
987 GTK_CELL_RENDERER (celltext)->mode = GTK_CELL_RENDERER_MODE_INERT;
988 g_object_notify (object, "editable_set");
991 case PROP_STRIKETHROUGH:
992 celltext->strikethrough = g_value_get_boolean (value);
993 celltext->strikethrough_set = TRUE;
994 g_object_notify (object, "strikethrough_set");
998 celltext->underline_style = g_value_get_enum (value);
999 celltext->underline_set = TRUE;
1000 g_object_notify (object, "underline_set");
1005 celltext->rise = g_value_get_int (value);
1006 celltext->rise_set = TRUE;
1007 g_object_notify (object, "rise_set");
1008 if (celltext->fixed_height_rows != -1)
1009 celltext->calc_fixed_height = TRUE;
1012 case PROP_BACKGROUND_SET:
1013 celltext->background_set = g_value_get_boolean (value);
1016 case PROP_FOREGROUND_SET:
1017 celltext->foreground_set = g_value_get_boolean (value);
1020 case PROP_FAMILY_SET:
1021 case PROP_STYLE_SET:
1022 case PROP_VARIANT_SET:
1023 case PROP_WEIGHT_SET:
1024 case PROP_STRETCH_SET:
1026 if (!g_value_get_boolean (value))
1028 pango_font_description_unset_fields (celltext->font,
1029 get_property_font_set_mask (param_id));
1033 PangoFontMask changed_mask;
1035 changed_mask = set_font_desc_fields (celltext->font,
1036 get_property_font_set_mask (param_id));
1037 notify_fields_changed (G_OBJECT (celltext), changed_mask);
1041 case PROP_SCALE_SET:
1042 celltext->scale_set = g_value_get_boolean (value);
1045 case PROP_EDITABLE_SET:
1046 celltext->editable_set = g_value_get_boolean (value);
1049 case PROP_STRIKETHROUGH_SET:
1050 celltext->strikethrough_set = g_value_get_boolean (value);
1053 case PROP_UNDERLINE_SET:
1054 celltext->underline_set = g_value_get_boolean (value);
1058 celltext->rise_set = g_value_get_boolean (value);
1062 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
1068 * gtk_cell_renderer_text_new:
1070 * Creates a new #GtkCellRendererText. Adjust how text is drawn using
1071 * object properties. Object properties can be
1072 * set globally (with g_object_set()). Also, with #GtkTreeViewColumn,
1073 * you can bind a property to a value in a #GtkTreeModel. For example,
1074 * you can bind the "text" property on the cell renderer to a string
1075 * value in the model, thus rendering a different string in each row
1076 * of the #GtkTreeView
1078 * Return value: the new cell renderer
1081 gtk_cell_renderer_text_new (void)
1083 return g_object_new (GTK_TYPE_CELL_RENDERER_TEXT, NULL);
1087 add_attr (PangoAttrList *attr_list,
1088 PangoAttribute *attr)
1090 attr->start_index = 0;
1091 attr->end_index = G_MAXINT;
1093 pango_attr_list_insert (attr_list, attr);
1097 get_layout (GtkCellRendererText *celltext,
1099 gboolean will_render,
1100 GtkCellRendererState flags)
1102 PangoAttrList *attr_list;
1103 PangoLayout *layout;
1104 PangoUnderline uline;
1106 layout = gtk_widget_create_pango_layout (widget, celltext->text);
1108 if (celltext->extra_attrs)
1109 attr_list = pango_attr_list_copy (celltext->extra_attrs);
1111 attr_list = pango_attr_list_new ();
1115 /* Add options that affect appearance but not size */
1117 /* note that background doesn't go here, since it affects
1118 * background_area not the PangoLayout area
1121 if (celltext->foreground_set)
1125 color = celltext->foreground;
1127 add_attr (attr_list,
1128 pango_attr_foreground_new (color.red, color.green, color.blue));
1131 if (celltext->strikethrough_set)
1132 add_attr (attr_list,
1133 pango_attr_strikethrough_new (celltext->strikethrough));
1136 add_attr (attr_list, pango_attr_font_desc_new (celltext->font));
1138 if (celltext->scale_set &&
1139 celltext->font_scale != 1.0)
1140 add_attr (attr_list, pango_attr_scale_new (celltext->font_scale));
1142 if (celltext->underline_set)
1143 uline = celltext->underline_style;
1145 uline = PANGO_UNDERLINE_NONE;
1147 if ((flags & GTK_CELL_RENDERER_PRELIT) == GTK_CELL_RENDERER_PRELIT)
1151 case PANGO_UNDERLINE_NONE:
1152 uline = PANGO_UNDERLINE_SINGLE;
1155 case PANGO_UNDERLINE_SINGLE:
1156 uline = PANGO_UNDERLINE_DOUBLE;
1164 if (uline != PANGO_UNDERLINE_NONE)
1165 add_attr (attr_list, pango_attr_underline_new (celltext->underline_style));
1167 if (celltext->rise_set)
1168 add_attr (attr_list, pango_attr_rise_new (celltext->rise));
1170 pango_layout_set_attributes (layout, attr_list);
1171 pango_layout_set_width (layout, -1);
1173 pango_attr_list_unref (attr_list);
1179 gtk_cell_renderer_text_get_size (GtkCellRenderer *cell,
1181 GdkRectangle *cell_area,
1187 GtkCellRendererText *celltext = (GtkCellRendererText *) cell;
1188 PangoRectangle rect;
1189 PangoLayout *layout;
1191 if (celltext->calc_fixed_height)
1193 PangoContext *context;
1194 PangoFontMetrics *metrics;
1195 PangoFontDescription *font_desc;
1198 font_desc = pango_font_description_copy (widget->style->font_desc);
1199 pango_font_description_merge (font_desc, celltext->font, TRUE);
1201 if (celltext->scale_set)
1202 pango_font_description_set_size (font_desc,
1203 celltext->font_scale * pango_font_description_get_size (font_desc));
1205 context = gtk_widget_get_pango_context (widget);
1207 metrics = pango_context_get_metrics (context,
1209 pango_context_get_language (context));
1210 row_height = (pango_font_metrics_get_ascent (metrics) +
1211 pango_font_metrics_get_descent (metrics));
1212 pango_font_metrics_unref (metrics);
1214 gtk_cell_renderer_set_fixed_size (cell,
1215 cell->width, 2*cell->ypad +
1216 celltext->fixed_height_rows * PANGO_PIXELS (row_height));
1220 *height = cell->height;
1223 celltext->calc_fixed_height = FALSE;
1227 layout = get_layout (celltext, widget, FALSE, 0);
1228 pango_layout_get_pixel_extents (layout, NULL, &rect);
1231 *width = GTK_CELL_RENDERER (celltext)->xpad * 2 + rect.width;
1234 *height = GTK_CELL_RENDERER (celltext)->ypad * 2 + rect.height;
1240 *x_offset = cell->xalign * (cell_area->width - rect.width - (2 * cell->xpad));
1241 *x_offset = MAX (*x_offset, 0);
1245 *y_offset = cell->yalign * (cell_area->height - rect.height - (2 * cell->ypad));
1246 *y_offset = MAX (*y_offset, 0);
1250 g_object_unref (layout);
1254 gtk_cell_renderer_text_render (GtkCellRenderer *cell,
1257 GdkRectangle *background_area,
1258 GdkRectangle *cell_area,
1259 GdkRectangle *expose_area,
1260 GtkCellRendererState flags)
1263 GtkCellRendererText *celltext = (GtkCellRendererText *) cell;
1264 PangoLayout *layout;
1269 layout = get_layout (celltext, widget, TRUE, flags);
1271 gtk_cell_renderer_text_get_size (cell, widget, cell_area, &x_offset, &y_offset, NULL, NULL);
1273 if ((flags & GTK_CELL_RENDERER_SELECTED) == GTK_CELL_RENDERER_SELECTED)
1275 if (GTK_WIDGET_HAS_FOCUS (widget))
1276 state = GTK_STATE_SELECTED;
1278 state = GTK_STATE_ACTIVE;
1282 if (GTK_WIDGET_STATE (widget) == GTK_STATE_INSENSITIVE)
1283 state = GTK_STATE_INSENSITIVE;
1285 state = GTK_STATE_NORMAL;
1288 if (celltext->background_set && state != GTK_STATE_SELECTED)
1293 color.red = celltext->background.red;
1294 color.green = celltext->background.green;
1295 color.blue = celltext->background.blue;
1297 gc = gdk_gc_new (window);
1299 gdk_gc_set_rgb_fg_color (gc, &color);
1301 gdk_draw_rectangle (window,
1306 background_area->width,
1307 background_area->height);
1309 g_object_unref (gc);
1312 gtk_paint_layout (widget->style,
1319 cell_area->x + x_offset + cell->xpad,
1320 cell_area->y + y_offset + cell->ypad,
1323 g_object_unref (layout);
1327 gtk_cell_renderer_text_editing_done (GtkCellEditable *entry,
1331 const gchar *new_text;
1332 GtkCellRendererInfo *info;
1334 info = g_object_get_data (G_OBJECT (data),
1335 GTK_CELL_RENDERER_INFO_KEY);
1337 if (info->focus_out_id > 0)
1339 g_signal_handler_disconnect (entry, info->focus_out_id);
1340 info->focus_out_id = 0;
1343 if (GTK_ENTRY (entry)->editing_canceled)
1346 path = g_object_get_data (G_OBJECT (entry), GTK_CELL_RENDERER_TEXT_PATH);
1347 new_text = gtk_entry_get_text (GTK_ENTRY (entry));
1349 g_signal_emit (data, text_cell_renderer_signals[EDITED], 0, path, new_text);
1353 gtk_cell_renderer_text_focus_out_event (GtkWidget *entry,
1357 gtk_cell_renderer_text_editing_done (GTK_CELL_EDITABLE (entry), data);
1359 /* entry needs focus-out-event */
1363 static GtkCellEditable *
1364 gtk_cell_renderer_text_start_editing (GtkCellRenderer *cell,
1368 GdkRectangle *background_area,
1369 GdkRectangle *cell_area,
1370 GtkCellRendererState flags)
1372 GtkCellRendererText *celltext;
1374 GtkCellRendererInfo *info;
1376 celltext = GTK_CELL_RENDERER_TEXT (cell);
1378 /* If the cell isn't editable we return NULL. */
1379 if (celltext->editable == FALSE)
1382 entry = g_object_new (GTK_TYPE_ENTRY,
1387 gtk_entry_set_text (GTK_ENTRY (entry), celltext->text);
1388 g_object_set_data_full (G_OBJECT (entry), GTK_CELL_RENDERER_TEXT_PATH, g_strdup (path), g_free);
1390 gtk_editable_select_region (GTK_EDITABLE (entry), 0, -1);
1392 info = g_object_get_data (G_OBJECT (cell),
1393 GTK_CELL_RENDERER_INFO_KEY);
1395 gtk_widget_show (entry);
1396 g_signal_connect (entry,
1398 G_CALLBACK (gtk_cell_renderer_text_editing_done),
1400 info->focus_out_id = g_signal_connect (entry, "focus_out_event",
1401 G_CALLBACK (gtk_cell_renderer_text_focus_out_event),
1404 return GTK_CELL_EDITABLE (entry);
1409 * gtk_cell_renderer_text_set_fixed_height_from_font:
1410 * @renderer: A #GtkCellRendererText
1411 * @number_of_rows: Number of rows of text each cell renderer is allocated, or -1
1413 * Sets the height of a renderer to explicitly be determined by the "font" and
1414 * "y_pad" property set on it. Further changes in these properties do not
1415 * affect the height, so they must be accompanied by a subsequent call to this
1416 * function. Using this function is unflexible, and should really only be used
1417 * if calculating the size of a cell is too slow (ie, a massive number of cells
1418 * displayed). If @number_of_rows is -1, then the fixed height is unset, and
1419 * the height is determined by the properties again.
1422 gtk_cell_renderer_text_set_fixed_height_from_font (GtkCellRendererText *renderer,
1423 gint number_of_rows)
1425 g_return_if_fail (GTK_IS_CELL_RENDERER_TEXT (renderer));
1426 g_return_if_fail (number_of_rows == -1 || number_of_rows > 0);
1428 if (number_of_rows == -1)
1430 gtk_cell_renderer_set_fixed_size (GTK_CELL_RENDERER (renderer),
1431 GTK_CELL_RENDERER (renderer)->width,
1436 renderer->fixed_height_rows = number_of_rows;
1437 renderer->calc_fixed_height = TRUE;