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 "gtksignal.h"
27 static void gtk_cell_renderer_text_init (GtkCellRendererText *celltext);
28 static void gtk_cell_renderer_text_class_init (GtkCellRendererTextClass *class);
29 static void gtk_cell_renderer_text_finalize (GObject *object);
31 static void gtk_cell_renderer_text_get_property (GObject *object,
35 static void gtk_cell_renderer_text_set_property (GObject *object,
39 static void gtk_cell_renderer_text_get_size (GtkCellRenderer *cell,
41 GdkRectangle *cell_area,
46 static void gtk_cell_renderer_text_render (GtkCellRenderer *cell,
49 GdkRectangle *background_area,
50 GdkRectangle *cell_area,
51 GdkRectangle *expose_area,
54 static GtkCellEditable *gtk_cell_renderer_text_start_editing (GtkCellRenderer *cell,
58 GdkRectangle *background_area,
59 GdkRectangle *cell_area,
60 GtkCellRendererState flags);
94 /* Whether-a-style-arg-is-set args */
105 PROP_STRIKETHROUGH_SET,
110 static gpointer parent_class;
111 static guint text_cell_renderer_signals [LAST_SIGNAL];
113 #define GTK_CELL_RENDERER_TEXT_PATH "gtk-cell-renderer-text-path"
116 gtk_cell_renderer_text_get_type (void)
118 static GtkType cell_text_type = 0;
122 static const GTypeInfo cell_text_info =
124 sizeof (GtkCellRendererTextClass),
125 NULL, /* base_init */
126 NULL, /* base_finalize */
127 (GClassInitFunc) gtk_cell_renderer_text_class_init,
128 NULL, /* class_finalize */
129 NULL, /* class_data */
130 sizeof (GtkCellRendererText),
132 (GInstanceInitFunc) gtk_cell_renderer_text_init,
135 cell_text_type = g_type_register_static (GTK_TYPE_CELL_RENDERER, "GtkCellRendererText", &cell_text_info, 0);
138 return cell_text_type;
142 gtk_cell_renderer_text_init (GtkCellRendererText *celltext)
144 GTK_CELL_RENDERER (celltext)->xalign = 0.0;
145 GTK_CELL_RENDERER (celltext)->yalign = 0.5;
146 GTK_CELL_RENDERER (celltext)->xpad = 2;
147 GTK_CELL_RENDERER (celltext)->ypad = 2;
148 GTK_CELL_RENDERER (celltext)->mode = GTK_CELL_RENDERER_MODE_EDITABLE;
149 celltext->fixed_height_rows = -1;
150 celltext->font = pango_font_description_new ();
154 gtk_cell_renderer_text_class_init (GtkCellRendererTextClass *class)
156 GObjectClass *object_class = G_OBJECT_CLASS (class);
157 GtkCellRendererClass *cell_class = GTK_CELL_RENDERER_CLASS (class);
159 parent_class = g_type_class_peek_parent (class);
161 object_class->finalize = gtk_cell_renderer_text_finalize;
163 object_class->get_property = gtk_cell_renderer_text_get_property;
164 object_class->set_property = gtk_cell_renderer_text_set_property;
166 cell_class->get_size = gtk_cell_renderer_text_get_size;
167 cell_class->render = gtk_cell_renderer_text_render;
168 cell_class->start_editing = gtk_cell_renderer_text_start_editing;
170 g_object_class_install_property (object_class,
172 g_param_spec_string ("text",
178 g_object_class_install_property (object_class,
180 g_param_spec_string ("markup",
182 _("Marked up text to render"),
186 g_object_class_install_property (object_class,
188 g_param_spec_boxed ("attributes",
190 _("A list of style attributes to apply to the text of the renderer."),
191 PANGO_TYPE_ATTR_LIST,
194 g_object_class_install_property (object_class,
196 g_param_spec_string ("background",
197 _("Background color name"),
198 _("Background color as a string"),
202 g_object_class_install_property (object_class,
204 g_param_spec_boxed ("background_gdk",
205 _("Background color"),
206 _("Background color as a GdkColor"),
208 G_PARAM_READABLE | G_PARAM_WRITABLE));
210 g_object_class_install_property (object_class,
212 g_param_spec_string ("foreground",
213 _("Foreground color name"),
214 _("Foreground color as a string"),
218 g_object_class_install_property (object_class,
220 g_param_spec_boxed ("foreground_gdk",
221 _("Foreground color"),
222 _("Foreground color as a GdkColor"),
224 G_PARAM_READABLE | G_PARAM_WRITABLE));
227 g_object_class_install_property (object_class,
229 g_param_spec_boolean ("editable",
231 _("Whether the text can be modified by the user"),
233 G_PARAM_READABLE | G_PARAM_WRITABLE));
235 g_object_class_install_property (object_class,
237 g_param_spec_string ("font",
239 _("Font description as a string"),
241 G_PARAM_READABLE | G_PARAM_WRITABLE));
243 g_object_class_install_property (object_class,
245 g_param_spec_boxed ("font_desc",
247 _("Font description as a PangoFontDescription struct"),
248 PANGO_TYPE_FONT_DESCRIPTION,
249 G_PARAM_READABLE | G_PARAM_WRITABLE));
252 g_object_class_install_property (object_class,
254 g_param_spec_string ("family",
256 _("Name of the font family, e.g. Sans, Helvetica, Times, Monospace"),
258 G_PARAM_READABLE | G_PARAM_WRITABLE));
260 g_object_class_install_property (object_class,
262 g_param_spec_enum ("style",
267 G_PARAM_READABLE | G_PARAM_WRITABLE));
269 g_object_class_install_property (object_class,
271 g_param_spec_enum ("variant",
275 PANGO_VARIANT_NORMAL,
276 G_PARAM_READABLE | G_PARAM_WRITABLE));
278 g_object_class_install_property (object_class,
280 g_param_spec_enum ("weight",
285 G_PARAM_READABLE | G_PARAM_WRITABLE));
288 g_object_class_install_property (object_class,
290 g_param_spec_enum ("stretch",
294 PANGO_STRETCH_NORMAL,
295 G_PARAM_READABLE | G_PARAM_WRITABLE));
297 g_object_class_install_property (object_class,
299 g_param_spec_int ("size",
305 G_PARAM_READABLE | G_PARAM_WRITABLE));
307 g_object_class_install_property (object_class,
309 g_param_spec_double ("size_points",
311 _("Font size in points"),
315 G_PARAM_READABLE | G_PARAM_WRITABLE));
317 g_object_class_install_property (object_class,
319 g_param_spec_double ("scale",
321 _("Font scaling factor"),
325 G_PARAM_READABLE | G_PARAM_WRITABLE));
327 g_object_class_install_property (object_class,
329 g_param_spec_int ("rise",
331 _("Offset of text above the baseline (below the baseline if rise is negative)"),
335 G_PARAM_READABLE | G_PARAM_WRITABLE));
338 g_object_class_install_property (object_class,
340 g_param_spec_boolean ("strikethrough",
342 _("Whether to strike through the text"),
344 G_PARAM_READABLE | G_PARAM_WRITABLE));
346 g_object_class_install_property (object_class,
348 g_param_spec_enum ("underline",
350 _("Style of underline for this text"),
351 PANGO_TYPE_UNDERLINE,
352 PANGO_UNDERLINE_NONE,
353 G_PARAM_READABLE | G_PARAM_WRITABLE));
355 /* Style props are set or not */
357 #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))
359 ADD_SET_PROP ("background_set", PROP_BACKGROUND_SET,
361 _("Whether this tag affects the background color"));
363 ADD_SET_PROP ("foreground_set", PROP_FOREGROUND_SET,
365 _("Whether this tag affects the foreground color"));
367 ADD_SET_PROP ("editable_set", PROP_EDITABLE_SET,
368 _("Editability set"),
369 _("Whether this tag affects text editability"));
371 ADD_SET_PROP ("family_set", PROP_FAMILY_SET,
372 _("Font family set"),
373 _("Whether this tag affects the font family"));
375 ADD_SET_PROP ("style_set", PROP_STYLE_SET,
377 _("Whether this tag affects the font style"));
379 ADD_SET_PROP ("variant_set", PROP_VARIANT_SET,
380 _("Font variant set"),
381 _("Whether this tag affects the font variant"));
383 ADD_SET_PROP ("weight_set", PROP_WEIGHT_SET,
384 _("Font weight set"),
385 _("Whether this tag affects the font weight"));
387 ADD_SET_PROP ("stretch_set", PROP_STRETCH_SET,
388 _("Font stretch set"),
389 _("Whether this tag affects the font stretch"));
391 ADD_SET_PROP ("size_set", PROP_SIZE_SET,
393 _("Whether this tag affects the font size"));
395 ADD_SET_PROP ("scale_set", PROP_SCALE_SET,
397 _("Whether this tag scales the font size by a factor"));
399 ADD_SET_PROP ("rise_set", PROP_RISE_SET,
401 _("Whether this tag affects the rise"));
403 ADD_SET_PROP ("strikethrough_set", PROP_STRIKETHROUGH_SET,
404 _("Strikethrough set"),
405 _("Whether this tag affects strikethrough"));
407 ADD_SET_PROP ("underline_set", PROP_UNDERLINE_SET,
409 _("Whether this tag affects underlining"));
411 text_cell_renderer_signals [EDITED] =
412 gtk_signal_new ("edited",
414 GTK_CLASS_TYPE (object_class),
415 GTK_SIGNAL_OFFSET (GtkCellRendererTextClass, edited),
416 gtk_marshal_VOID__STRING_STRING,
424 gtk_cell_renderer_text_finalize (GObject *object)
426 GtkCellRendererText *celltext = GTK_CELL_RENDERER_TEXT (object);
428 pango_font_description_free (celltext->font);
431 g_free (celltext->text);
433 if (celltext->extra_attrs)
434 pango_attr_list_unref (celltext->extra_attrs);
436 (* G_OBJECT_CLASS (parent_class)->finalize) (object);
440 get_property_font_set_mask (guint prop_id)
444 case PROP_FAMILY_SET:
445 return PANGO_FONT_MASK_FAMILY;
447 return PANGO_FONT_MASK_STYLE;
448 case PROP_VARIANT_SET:
449 return PANGO_FONT_MASK_VARIANT;
450 case PROP_WEIGHT_SET:
451 return PANGO_FONT_MASK_WEIGHT;
452 case PROP_STRETCH_SET:
453 return PANGO_FONT_MASK_STRETCH;
455 return PANGO_FONT_MASK_SIZE;
462 gtk_cell_renderer_text_get_property (GObject *object,
467 GtkCellRendererText *celltext = GTK_CELL_RENDERER_TEXT (object);
472 g_value_set_string (value, celltext->text);
475 case PROP_ATTRIBUTES:
476 g_value_set_boxed (value, celltext->extra_attrs);
479 case PROP_BACKGROUND_GDK:
483 color.red = celltext->background.red;
484 color.green = celltext->background.green;
485 color.blue = celltext->background.blue;
487 g_value_set_boxed (value, &color);
491 case PROP_FOREGROUND_GDK:
495 color.red = celltext->foreground.red;
496 color.green = celltext->foreground.green;
497 color.blue = celltext->foreground.blue;
499 g_value_set_boxed (value, &color);
505 /* FIXME GValue imposes a totally gratuitous string copy
506 * here, we could just hand off string ownership
508 gchar *str = pango_font_description_to_string (celltext->font);
509 g_value_set_string (value, str);
515 g_value_set_boxed (value, celltext->font);
519 g_value_set_string (value, pango_font_description_get_family (celltext->font));
523 g_value_set_enum (value, pango_font_description_get_style (celltext->font));
527 g_value_set_enum (value, pango_font_description_get_variant (celltext->font));
531 g_value_set_int (value, pango_font_description_get_weight (celltext->font));
535 g_value_set_enum (value, pango_font_description_get_stretch (celltext->font));
539 g_value_set_int (value, pango_font_description_get_size (celltext->font));
542 case PROP_SIZE_POINTS:
543 g_value_set_double (value, ((double)pango_font_description_get_size (celltext->font)) / (double)PANGO_SCALE);
547 g_value_set_double (value, celltext->font_scale);
551 g_value_set_boolean (value, celltext->editable);
554 case PROP_STRIKETHROUGH:
555 g_value_set_boolean (value, celltext->strikethrough);
559 g_value_set_enum (value, celltext->underline_style);
563 g_value_set_int (value, celltext->rise);
566 case PROP_BACKGROUND_SET:
567 g_value_set_boolean (value, celltext->background_set);
570 case PROP_FOREGROUND_SET:
571 g_value_set_boolean (value, celltext->foreground_set);
574 case PROP_FAMILY_SET:
576 case PROP_VARIANT_SET:
577 case PROP_WEIGHT_SET:
578 case PROP_STRETCH_SET:
581 PangoFontMask mask = get_property_font_set_mask (param_id);
582 g_value_set_boolean (value, (pango_font_description_get_set_fields (celltext->font) & mask) != 0);
588 g_value_set_boolean (value, celltext->scale_set);
591 case PROP_EDITABLE_SET:
592 g_value_set_boolean (value, celltext->editable_set);
595 case PROP_STRIKETHROUGH_SET:
596 g_value_set_boolean (value, celltext->strikethrough_set);
599 case PROP_UNDERLINE_SET:
600 g_value_set_boolean (value, celltext->underline_set);
604 g_value_set_boolean (value, celltext->rise_set);
607 case PROP_BACKGROUND:
608 case PROP_FOREGROUND:
611 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
618 set_bg_color (GtkCellRendererText *celltext,
623 if (!celltext->background_set)
625 celltext->background_set = TRUE;
626 g_object_notify (G_OBJECT (celltext), "background_set");
629 celltext->background.red = color->red;
630 celltext->background.green = color->green;
631 celltext->background.blue = color->blue;
635 if (celltext->background_set)
637 celltext->background_set = FALSE;
638 g_object_notify (G_OBJECT (celltext), "background_set");
645 set_fg_color (GtkCellRendererText *celltext,
650 if (!celltext->foreground_set)
652 celltext->foreground_set = TRUE;
653 g_object_notify (G_OBJECT (celltext), "foreground_set");
656 celltext->foreground.red = color->red;
657 celltext->foreground.green = color->green;
658 celltext->foreground.blue = color->blue;
662 if (celltext->foreground_set)
664 celltext->foreground_set = FALSE;
665 g_object_notify (G_OBJECT (celltext), "foreground_set");
671 set_font_desc_fields (PangoFontDescription *desc,
672 PangoFontMask to_set)
674 PangoFontMask changed_mask = 0;
676 if (to_set & PANGO_FONT_MASK_FAMILY)
678 const char *family = pango_font_description_get_family (desc);
682 changed_mask |= PANGO_FONT_MASK_FAMILY;
685 pango_font_description_set_family (desc, family);
687 if (to_set & PANGO_FONT_MASK_STYLE)
688 pango_font_description_set_style (desc, pango_font_description_get_style (desc));
689 if (to_set & PANGO_FONT_MASK_VARIANT)
690 pango_font_description_set_variant (desc, pango_font_description_get_variant (desc));
691 if (to_set & PANGO_FONT_MASK_WEIGHT)
692 pango_font_description_set_weight (desc, pango_font_description_get_weight (desc));
693 if (to_set & PANGO_FONT_MASK_STRETCH)
694 pango_font_description_set_stretch (desc, pango_font_description_get_stretch (desc));
695 if (to_set & PANGO_FONT_MASK_SIZE)
697 gint size = pango_font_description_get_size (desc);
700 size = 10 * PANGO_SCALE;
701 changed_mask |= PANGO_FONT_MASK_SIZE;
704 pango_font_description_set_size (desc, size);
711 notify_set_changed (GObject *object,
712 PangoFontMask changed_mask)
714 if (changed_mask & PANGO_FONT_MASK_FAMILY)
715 g_object_notify (object, "family_set");
716 if (changed_mask & PANGO_FONT_MASK_STYLE)
717 g_object_notify (object, "style_set");
718 if (changed_mask & PANGO_FONT_MASK_VARIANT)
719 g_object_notify (object, "variant_set");
720 if (changed_mask & PANGO_FONT_MASK_WEIGHT)
721 g_object_notify (object, "weight_set");
722 if (changed_mask & PANGO_FONT_MASK_STRETCH)
723 g_object_notify (object, "stretch_set");
724 if (changed_mask & PANGO_FONT_MASK_SIZE)
725 g_object_notify (object, "size_set");
729 notify_fields_changed (GObject *object,
730 PangoFontMask changed_mask)
732 if (changed_mask & PANGO_FONT_MASK_FAMILY)
733 g_object_notify (object, "family");
734 if (changed_mask & PANGO_FONT_MASK_STYLE)
735 g_object_notify (object, "style");
736 if (changed_mask & PANGO_FONT_MASK_VARIANT)
737 g_object_notify (object, "variant");
738 if (changed_mask & PANGO_FONT_MASK_WEIGHT)
739 g_object_notify (object, "weight");
740 if (changed_mask & PANGO_FONT_MASK_STRETCH)
741 g_object_notify (object, "stretch");
742 if (changed_mask & PANGO_FONT_MASK_SIZE)
743 g_object_notify (object, "size");
747 set_font_description (GtkCellRendererText *celltext,
748 PangoFontDescription *font_desc)
750 GObject *object = G_OBJECT (celltext);
751 PangoFontDescription *new_font_desc;
752 PangoFontMask old_mask, new_mask, changed_mask, set_changed_mask;
755 new_font_desc = pango_font_description_copy (font_desc);
757 new_font_desc = pango_font_description_new ();
759 old_mask = pango_font_description_get_set_fields (celltext->font);
760 new_mask = pango_font_description_get_set_fields (new_font_desc);
762 changed_mask = old_mask | new_mask;
763 set_changed_mask = old_mask ^ new_mask;
765 pango_font_description_free (celltext->font);
766 celltext->font = new_font_desc;
768 g_object_freeze_notify (object);
770 g_object_notify (object, "font_desc");
771 g_object_notify (object, "font");
773 if (changed_mask & PANGO_FONT_MASK_FAMILY)
774 g_object_notify (object, "family");
775 if (changed_mask & PANGO_FONT_MASK_STYLE)
776 g_object_notify (object, "style");
777 if (changed_mask & PANGO_FONT_MASK_VARIANT)
778 g_object_notify (object, "variant");
779 if (changed_mask & PANGO_FONT_MASK_WEIGHT)
780 g_object_notify (object, "weight");
781 if (changed_mask & PANGO_FONT_MASK_STRETCH)
782 g_object_notify (object, "stretch");
783 if (changed_mask & PANGO_FONT_MASK_SIZE)
785 g_object_notify (object, "size");
786 g_object_notify (object, "size_points");
789 notify_set_changed (object, set_changed_mask);
791 g_object_thaw_notify (object);
795 gtk_cell_renderer_text_set_property (GObject *object,
800 GtkCellRendererText *celltext = GTK_CELL_RENDERER_TEXT (object);
806 g_free (celltext->text);
807 celltext->text = g_strdup (g_value_get_string (value));
808 g_object_notify (object, "text");
811 case PROP_ATTRIBUTES:
812 if (celltext->extra_attrs)
813 pango_attr_list_unref (celltext->extra_attrs);
815 celltext->extra_attrs = g_value_get_boxed (value);
816 if (celltext->extra_attrs)
817 pango_attr_list_ref (celltext->extra_attrs);
823 GError *error = NULL;
824 PangoAttrList *attrs = NULL;
827 g_free (celltext->text);
829 if (celltext->extra_attrs)
830 pango_attr_list_unref (celltext->extra_attrs);
832 str = g_value_get_string (value);
833 if (str && !pango_parse_markup (str,
841 g_warning ("Failed to set cell text from markup due to error parsing markup: %s",
843 g_error_free (error);
847 celltext->text = text;
848 celltext->extra_attrs = attrs;
852 case PROP_BACKGROUND:
856 if (!g_value_get_string (value))
857 set_bg_color (celltext, NULL); /* reset to backgrounmd_set to FALSE */
858 else if (gdk_color_parse (g_value_get_string (value), &color))
859 set_bg_color (celltext, &color);
861 g_warning ("Don't know color `%s'", g_value_get_string (value));
863 g_object_notify (object, "background_gdk");
867 case PROP_FOREGROUND:
871 if (!g_value_get_string (value))
872 set_fg_color (celltext, NULL); /* reset to foreground_set to FALSE */
873 else if (gdk_color_parse (g_value_get_string (value), &color))
874 set_fg_color (celltext, &color);
876 g_warning ("Don't know color `%s'", g_value_get_string (value));
878 g_object_notify (object, "foreground_gdk");
882 case PROP_BACKGROUND_GDK:
883 /* This notifies the GObject itself. */
884 set_bg_color (celltext, g_value_get_boxed (value));
887 case PROP_FOREGROUND_GDK:
888 /* This notifies the GObject itself. */
889 set_fg_color (celltext, g_value_get_boxed (value));
894 PangoFontDescription *font_desc = NULL;
897 name = g_value_get_string (value);
900 font_desc = pango_font_description_from_string (name);
902 set_font_description (celltext, font_desc);
904 if (celltext->fixed_height_rows != -1)
905 celltext->calc_fixed_height = TRUE;
910 set_font_description (celltext, g_value_get_boxed (value));
912 if (celltext->fixed_height_rows != -1)
913 celltext->calc_fixed_height = TRUE;
922 case PROP_SIZE_POINTS:
924 PangoFontMask old_set_mask = pango_font_description_get_set_fields (celltext->font);
929 pango_font_description_set_family (celltext->font,
930 g_value_get_string (value));
933 pango_font_description_set_style (celltext->font,
934 g_value_get_enum (value));
937 pango_font_description_set_variant (celltext->font,
938 g_value_get_enum (value));
941 pango_font_description_set_weight (celltext->font,
942 g_value_get_enum (value));
945 pango_font_description_set_stretch (celltext->font,
946 g_value_get_enum (value));
949 pango_font_description_set_size (celltext->font,
950 g_value_get_int (value));
951 g_object_notify (object, "size_points");
953 case PROP_SIZE_POINTS:
954 pango_font_description_set_size (celltext->font,
955 g_value_get_double (value) * PANGO_SCALE);
956 g_object_notify (object, "size");
960 if (celltext->fixed_height_rows != -1)
961 celltext->calc_fixed_height = TRUE;
963 notify_set_changed (object, old_set_mask & pango_font_description_get_set_fields (celltext->font));
964 g_object_notify (object, "font_desc");
965 g_object_notify (object, "font");
971 celltext->font_scale = g_value_get_double (value);
972 celltext->scale_set = TRUE;
973 if (celltext->fixed_height_rows != -1)
974 celltext->calc_fixed_height = TRUE;
975 g_object_notify (object, "scale_set");
979 celltext->editable = g_value_get_boolean (value);
980 celltext->editable_set = TRUE;
981 g_object_notify (object, "editable_set");
984 case PROP_STRIKETHROUGH:
985 celltext->strikethrough = g_value_get_boolean (value);
986 celltext->strikethrough_set = TRUE;
987 g_object_notify (object, "strikethrough_set");
991 celltext->underline_style = g_value_get_enum (value);
992 celltext->underline_set = TRUE;
993 g_object_notify (object, "underline_set");
998 celltext->rise = g_value_get_int (value);
999 celltext->rise_set = TRUE;
1000 g_object_notify (object, "rise_set");
1001 if (celltext->fixed_height_rows != -1)
1002 celltext->calc_fixed_height = TRUE;
1005 case PROP_BACKGROUND_SET:
1006 celltext->background_set = g_value_get_boolean (value);
1009 case PROP_FOREGROUND_SET:
1010 celltext->foreground_set = g_value_get_boolean (value);
1013 case PROP_FAMILY_SET:
1014 case PROP_STYLE_SET:
1015 case PROP_VARIANT_SET:
1016 case PROP_WEIGHT_SET:
1017 case PROP_STRETCH_SET:
1019 if (!g_value_get_boolean (value))
1021 pango_font_description_unset_fields (celltext->font,
1022 get_property_font_set_mask (param_id));
1026 PangoFontMask changed_mask;
1028 changed_mask = set_font_desc_fields (celltext->font,
1029 get_property_font_set_mask (param_id));
1030 notify_fields_changed (G_OBJECT (celltext), changed_mask);
1034 case PROP_SCALE_SET:
1035 celltext->scale_set = g_value_get_boolean (value);
1038 case PROP_EDITABLE_SET:
1039 celltext->editable_set = g_value_get_boolean (value);
1042 case PROP_STRIKETHROUGH_SET:
1043 celltext->strikethrough_set = g_value_get_boolean (value);
1046 case PROP_UNDERLINE_SET:
1047 celltext->underline_set = g_value_get_boolean (value);
1051 celltext->rise_set = g_value_get_boolean (value);
1055 G_OBJECT_WARN_INVALID_PROPERTY_ID (object, param_id, pspec);
1061 * gtk_cell_renderer_text_new:
1063 * Creates a new #GtkCellRendererText. Adjust how text is drawn using
1064 * object properties. Object properties can be
1065 * set globally (with g_object_set()). Also, with #GtkTreeViewColumn,
1066 * you can bind a property to a value in a #GtkTreeModel. For example,
1067 * you can bind the "text" property on the cell renderer to a string
1068 * value in the model, thus rendering a different string in each row
1069 * of the #GtkTreeView
1071 * Return value: the new cell renderer
1074 gtk_cell_renderer_text_new (void)
1076 return GTK_CELL_RENDERER (g_object_new (gtk_cell_renderer_text_get_type (), NULL));
1080 add_attr (PangoAttrList *attr_list,
1081 PangoAttribute *attr)
1083 attr->start_index = 0;
1084 attr->end_index = G_MAXINT;
1086 pango_attr_list_insert (attr_list, attr);
1090 get_layout (GtkCellRendererText *celltext,
1092 gboolean will_render,
1093 GtkCellRendererState flags)
1095 PangoAttrList *attr_list;
1096 PangoLayout *layout;
1097 PangoUnderline uline;
1099 layout = gtk_widget_create_pango_layout (widget, celltext->text);
1101 if (celltext->extra_attrs)
1102 attr_list = pango_attr_list_copy (celltext->extra_attrs);
1104 attr_list = pango_attr_list_new ();
1108 /* Add options that affect appearance but not size */
1110 /* note that background doesn't go here, since it affects
1111 * background_area not the PangoLayout area
1114 if (celltext->foreground_set)
1118 color = celltext->foreground;
1120 add_attr (attr_list,
1121 pango_attr_foreground_new (color.red, color.green, color.blue));
1124 if (celltext->strikethrough_set)
1125 add_attr (attr_list,
1126 pango_attr_strikethrough_new (celltext->strikethrough));
1129 add_attr (attr_list, pango_attr_font_desc_new (celltext->font));
1131 if (celltext->scale_set &&
1132 celltext->font_scale != 1.0)
1133 add_attr (attr_list, pango_attr_scale_new (celltext->font_scale));
1135 if (celltext->underline_set)
1136 uline = celltext->underline_style;
1138 uline = PANGO_UNDERLINE_NONE;
1140 if ((flags & GTK_CELL_RENDERER_PRELIT) == GTK_CELL_RENDERER_PRELIT)
1144 case PANGO_UNDERLINE_NONE:
1145 uline = PANGO_UNDERLINE_SINGLE;
1148 case PANGO_UNDERLINE_SINGLE:
1149 uline = PANGO_UNDERLINE_DOUBLE;
1157 if (uline != PANGO_UNDERLINE_NONE)
1158 add_attr (attr_list, pango_attr_underline_new (celltext->underline_style));
1160 if (celltext->rise_set)
1161 add_attr (attr_list, pango_attr_rise_new (celltext->rise));
1163 pango_layout_set_attributes (layout, attr_list);
1164 pango_layout_set_width (layout, -1);
1166 pango_attr_list_unref (attr_list);
1172 gtk_cell_renderer_text_get_size (GtkCellRenderer *cell,
1174 GdkRectangle *cell_area,
1180 GtkCellRendererText *celltext = (GtkCellRendererText *) cell;
1181 PangoRectangle rect;
1182 PangoLayout *layout;
1184 if (celltext->calc_fixed_height)
1186 PangoContext *context;
1187 PangoFontMetrics *metrics;
1188 PangoFontDescription *font_desc;
1191 font_desc = pango_font_description_copy (widget->style->font_desc);
1192 pango_font_description_merge (font_desc, celltext->font, TRUE);
1194 if (celltext->scale_set)
1195 pango_font_description_set_size (font_desc,
1196 celltext->font_scale * pango_font_description_get_size (font_desc));
1198 context = gtk_widget_get_pango_context (widget);
1200 metrics = pango_context_get_metrics (context,
1202 pango_context_get_language (context));
1203 row_height = (pango_font_metrics_get_ascent (metrics) +
1204 pango_font_metrics_get_descent (metrics));
1205 pango_font_metrics_unref (metrics);
1207 gtk_cell_renderer_set_fixed_size (cell,
1208 cell->width, 2*cell->ypad +
1209 celltext->fixed_height_rows * PANGO_PIXELS (row_height));
1213 *height = cell->height;
1216 celltext->calc_fixed_height = FALSE;
1220 layout = get_layout (celltext, widget, FALSE, 0);
1221 pango_layout_get_pixel_extents (layout, NULL, &rect);
1224 *width = GTK_CELL_RENDERER (celltext)->xpad * 2 + rect.width;
1227 *height = GTK_CELL_RENDERER (celltext)->ypad * 2 + rect.height;
1233 *x_offset = cell->xalign * (cell_area->width - rect.width - (2 * cell->xpad));
1234 *x_offset = MAX (*x_offset, 0);
1238 *y_offset = cell->yalign * (cell_area->height - rect.height - (2 * cell->ypad));
1239 *y_offset = MAX (*y_offset, 0);
1243 g_object_unref (G_OBJECT (layout));
1247 gtk_cell_renderer_text_render (GtkCellRenderer *cell,
1250 GdkRectangle *background_area,
1251 GdkRectangle *cell_area,
1252 GdkRectangle *expose_area,
1256 GtkCellRendererText *celltext = (GtkCellRendererText *) cell;
1257 PangoLayout *layout;
1262 layout = get_layout (celltext, widget, TRUE, flags);
1264 gtk_cell_renderer_text_get_size (cell, widget, cell_area, &x_offset, &y_offset, NULL, NULL);
1266 if ((flags & GTK_CELL_RENDERER_SELECTED) == GTK_CELL_RENDERER_SELECTED)
1268 if (GTK_WIDGET_HAS_FOCUS (widget))
1269 state = GTK_STATE_SELECTED;
1271 state = GTK_STATE_ACTIVE;
1275 state = GTK_STATE_NORMAL;
1278 if (celltext->background_set && state != GTK_STATE_SELECTED)
1283 color.red = celltext->background.red;
1284 color.green = celltext->background.green;
1285 color.blue = celltext->background.blue;
1287 gc = gdk_gc_new (window);
1289 gdk_gc_set_rgb_fg_color (gc, &color);
1291 gdk_draw_rectangle (window,
1296 background_area->width,
1297 background_area->height);
1299 g_object_unref (G_OBJECT (gc));
1302 gtk_paint_layout (widget->style,
1309 cell_area->x + x_offset + cell->xpad,
1310 cell_area->y + y_offset + cell->ypad,
1313 g_object_unref (G_OBJECT (layout));
1316 gtk_cell_renderer_text_editing_done (GtkCellEditable *entry,
1322 path = g_object_get_data (G_OBJECT (entry), GTK_CELL_RENDERER_TEXT_PATH);
1323 new_text = gtk_entry_get_text (GTK_ENTRY (entry));
1325 gtk_signal_emit (GTK_OBJECT (data), text_cell_renderer_signals[EDITED], path, new_text);
1328 static GtkCellEditable *
1329 gtk_cell_renderer_text_start_editing (GtkCellRenderer *cell,
1333 GdkRectangle *background_area,
1334 GdkRectangle *cell_area,
1335 GtkCellRendererState flags)
1337 GtkCellRendererText *celltext;
1340 celltext = GTK_CELL_RENDERER_TEXT (cell);
1342 /* If the cell isn't editable we return NULL. */
1343 if (celltext->editable == FALSE)
1346 entry = g_object_new (GTK_TYPE_ENTRY,
1350 gtk_entry_set_text (GTK_ENTRY (entry), celltext->text);
1351 g_object_set_data_full (G_OBJECT (entry), GTK_CELL_RENDERER_TEXT_PATH, g_strdup (path), g_free);
1353 gtk_editable_select_region (GTK_EDITABLE (entry), 0, -1);
1355 gtk_widget_show (entry);
1356 gtk_signal_connect (GTK_OBJECT (entry),
1358 G_CALLBACK (gtk_cell_renderer_text_editing_done),
1360 return GTK_CELL_EDITABLE (entry);
1365 * gtk_cell_renderer_text_set_fixed_height_from_font:
1366 * @renderer: A #GtkCellRendererText
1367 * @number_of_rows: Number of rows of text each cell renderer is allocated, or -1
1369 * Sets the height of a renderer to explicitly be determined by the "font" and
1370 * "y_pad" property set on it. Further changes in these properties do not
1371 * affect the height, so they must be accompanied by a subsequent call to this
1372 * function. Using this function is unflexible, and should really only be used
1373 * if calculating the size of a cell is too slow (ie, a massive number of cells
1374 * displayed). If @number_of_rows is -1, then the fixed height is unset, and
1375 * the height is determined by the properties again.
1378 gtk_cell_renderer_text_set_fixed_height_from_font (GtkCellRendererText *renderer,
1379 gint number_of_rows)
1381 g_return_if_fail (GTK_IS_CELL_RENDERER_TEXT (renderer));
1382 g_return_if_fail (number_of_rows == -1 || number_of_rows > 0);
1384 if (number_of_rows == -1)
1386 gtk_cell_renderer_set_fixed_size (GTK_CELL_RENDERER (renderer),
1387 GTK_CELL_RENDERER (renderer)->width,
1392 renderer->fixed_height_rows = number_of_rows;
1393 renderer->calc_fixed_height = TRUE;