## GtkCellRendererText

GtkCellRendererText — Renders text in a cell

## Synopsis

    #include <gtk/gtk.h>

    struct      GtkCellRendererText;
    GtkCellRenderer* gtk_cell_renderer_text_new (void);
    void        gtk_cell_renderer_text_set_fixed_height_from_font
                                                (GtkCellRendererText *renderer,
                                                 gint number_of_rows);

## Object Hierarchy

      GObject
       +----GtkObject
             +----GtkCellRenderer
                   +----GtkCellRendererText

## Properties

      "attributes"           PangoAttrList        : Read / Write
      "background"           gchararray           : Write
      "background-gdk"       GdkColor             : Read / Write
      "background-set"       gboolean             : Read / Write
      "editable"             gboolean             : Read / Write
      "editable-set"         gboolean             : Read / Write
      "family"               gchararray           : Read / Write
      "family-set"           gboolean             : Read / Write
      "font"                 gchararray           : Read / Write
      "font-desc"            PangoFontDescription : Read / Write
      "foreground"           gchararray           : Write
      "foreground-gdk"       GdkColor             : Read / Write
      "foreground-set"       gboolean             : Read / Write
      "language"             gchararray           : Read / Write
      "language-set"         gboolean             : Read / Write
      "markup"               gchararray           : Write
      "rise"                 gint                 : Read / Write
      "rise-set"             gboolean             : Read / Write
      "scale"                gdouble              : Read / Write
      "scale-set"            gboolean             : Read / Write
      "single-paragraph-mode" gboolean             : Read / Write
      "size"                 gint                 : Read / Write
      "size-points"          gdouble              : Read / Write
      "size-set"             gboolean             : Read / Write
      "stretch"              PangoStretch         : Read / Write
      "stretch-set"          gboolean             : Read / Write
      "strikethrough"        gboolean             : Read / Write
      "strikethrough-set"    gboolean             : Read / Write
      "style"                PangoStyle           : Read / Write
      "style-set"            gboolean             : Read / Write
      "text"                 gchararray           : Read / Write
      "underline"            PangoUnderline       : Read / Write
      "underline-set"        gboolean             : Read / Write
      "variant"              PangoVariant         : Read / Write
      "variant-set"          gboolean             : Read / Write
      "weight"               gint                 : Read / Write
      "weight-set"           gboolean             : Read / Write

## Signal Prototypes

    "edited"    void        user_function      (GtkCellRendererText *cellrenderertext,
                                                gchar *arg1,
                                                gchar *arg2,
                                                gpointer user_data);

## Description

## Details

### struct GtkCellRendererText

    struct GtkCellRendererText;

### gtk_cell_renderer_text_new ()

    GtkCellRenderer* gtk_cell_renderer_text_new (void);

Creates a new GtkCellRendererText. Adjust how text is drawn using object properties. Object properties can be set globally (with `g_object_set()`). Also, with GtkTreeViewColumn, you can bind a property to a value in a GtkTreeModel. For example, you can bind the "text" property on the cell renderer to a string value in the model, thus rendering a different string in each row of the GtkTreeView

Returns : | the new cell renderer

### gtk_cell_renderer_text_set_fixed_height_from_font ()

    void        gtk_cell_renderer_text_set_fixed_height_from_font
                                                (GtkCellRendererText *renderer,
                                                 gint number_of_rows);

Sets the height of a renderer to explicitly be determined by the "font" and "y_pad" property set on it. Further changes in these properties do not affect the height, so they must be accompanied by a subsequent call to this function. Using this function is unflexible, and should really only be used if calculating the size of a cell is too slow (ie, a massive number of cells displayed). If `number_of_rows` is -1, then the fixed height is unset, and the height is determined by the properties again.

`renderer` : | A GtkCellRendererText
`number_of_rows` : | Number of rows of text each cell renderer is allocated, or -1

## Properties

"`attributes`" (PangoAttrList : Read / Write) | A list of style attributes to apply to the text of the renderer.
"`background`" (gchararray : Write) | Background color as a string.
"`background-gdk`" (GdkColor : Read / Write) | Background color as a GdkColor.
"`background-set`" (gboolean : Read / Write) | Whether this tag affects the background color.
"`editable`" (gboolean : Read / Write) | Whether the text can be modified by the user.
"`editable-set`" (gboolean : Read / Write) | Whether this tag affects text editability.
"`family`" (gchararray : Read / Write) | Name of the font family, e.g. Sans, Helvetica, Times, Monospace.
"`family-set`" (gboolean : Read / Write) | Whether this tag affects the font family.
"`font`" (gchararray : Read / Write) | Font description as a string.
"`font-desc`" (PangoFontDescription : Read / Write) | Font description as a PangoFontDescription struct.
"`foreground`" (gchararray : Write) | Foreground color as a string.
"`foreground-gdk`" (GdkColor : Read / Write) | Foreground color as a GdkColor.
"`foreground-set`" (gboolean : Read / Write) | Whether this tag affects the foreground color.
"`language`" (gchararray : Read / Write) | The language this text is in, as an ISO code. Pango can use this as a hint when rendering the text. If you don't understand this parameter, you probably don't need it.
"`language-set`" (gboolean : Read / Write) | Whether this tag affects the language the text is rendered as.
"`markup`" (gchararray : Write) | Marked up text to render.
"`rise`" (gint : Read / Write) | Offset of text above the baseline (below the baseline if rise is negative).
"`rise-set`" (gboolean : Read / Write) | Whether this tag affects the rise.
"`scale`" (gdouble : Read / Write) | Font scaling factor.
"`scale-set`" (gboolean : Read / Write) | Whether this tag scales the font size by a factor.
"`single-paragraph-mode`" (gboolean : Read / Write) | Whether or not to keep all text in a single paragraph.
"`size`" (gint : Read / Write) | Font size.
"`size-points`" (gdouble : Read / Write) | Font size in points.
"`size-set`" (gboolean : Read / Write) | Whether this tag affects the font size.
"`stretch`" (PangoStretch : Read / Write) | Font stretch.
"`stretch-set`" (gboolean : Read / Write) | Whether this tag affects the font stretch.
"`strikethrough`" (gboolean : Read / Write) | Whether to strike through the text.
"`strikethrough-set`" (gboolean : Read / Write) | Whether this tag affects strikethrough.
"`style`" (PangoStyle : Read / Write) | Font style.
"`style-set`" (gboolean : Read / Write) | Whether this tag affects the font style.
"`text`" (gchararray : Read / Write) | Text to render.
"`underline`" (PangoUnderline : Read / Write) | Style of underline for this text.
"`underline-set`" (gboolean : Read / Write) | Whether this tag affects underlining.
"`variant`" (PangoVariant : Read / Write) | Font variant.
"`variant-set`" (gboolean : Read / Write) | Whether this tag affects the font variant.
"`weight`" (gint : Read / Write) | Font weight.
"`weight-set`" (gboolean : Read / Write) | Whether this tag affects the font weight.

## Signals

### The "edited" signal

    void        user_function                  (GtkCellRendererText *cellrenderertext,
                                                gchar *arg1,
                                                gchar *arg2,
                                                gpointer user_data);

`cellrenderertext` : | the object which received the signal.
`arg1` : |
`arg2` : |
`user_data` : | user data set when the signal handler was connected.