## 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

### The "`attributes`" property

      "attributes"           PangoAttrList         : Read / Write

A list of style attributes to apply to the text of the renderer.

### The "`background`" property

      "background"           gchararray            : Write

Background color as a string.

Default value: NULL

### The "`background-gdk`" property

      "background-gdk"       GdkColor              : Read / Write

Background color as a GdkColor.

### The "`background-set`" property

      "background-set"       gboolean              : Read / Write

Whether this tag affects the background color.

Default value: FALSE

### The "`editable`" property

      "editable"             gboolean              : Read / Write

Whether the text can be modified by the user.

Default value: FALSE

### The "`editable-set`" property

      "editable-set"         gboolean              : Read / Write

Whether this tag affects text editability.

Default value: FALSE

### The "`family`" property

      "family"               gchararray            : Read / Write

Name of the font family, e.g. Sans, Helvetica, Times, Monospace.

Default value: NULL

### The "`family-set`" property

      "family-set"           gboolean              : Read / Write

Whether this tag affects the font family.

Default value: FALSE

### The "`font`" property

      "font"                 gchararray            : Read / Write

Font description as a string.

Default value: NULL

### The "`font-desc`" property

      "font-desc"            PangoFontDescription  : Read / Write

Font description as a PangoFontDescription struct.

### The "`foreground`" property

      "foreground"           gchararray            : Write

Foreground color as a string.

Default value: NULL

### The "`foreground-gdk`" property

      "foreground-gdk"       GdkColor              : Read / Write

Foreground color as a GdkColor.

### The "`foreground-set`" property

      "foreground-set"       gboolean              : Read / Write

Whether this tag affects the foreground color.

Default value: FALSE

### The "`language`" property

      "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.

Default value: NULL

### The "`language-set`" property

      "language-set"         gboolean              : Read / Write

Whether this tag affects the language the text is rendered as.

Default value: FALSE

### The "`markup`" property

      "markup"               gchararray            : Write

Marked up text to render.

Default value: NULL

### The "`rise`" property

      "rise"                 gint                  : Read / Write

Offset of text above the baseline (below the baseline if rise is negative).

Allowed values: >= -2147483647

Default value: 0

### The "`rise-set`" property

      "rise-set"             gboolean              : Read / Write

Whether this tag affects the rise.

Default value: FALSE

### The "`scale`" property

      "scale"                gdouble               : Read / Write

Font scaling factor.

Allowed values: >= 0

Default value: 1

### The "`scale-set`" property

      "scale-set"            gboolean              : Read / Write

Whether this tag scales the font size by a factor.

Default value: FALSE

### The "`single-paragraph-mode`" property

      "single-paragraph-mode" gboolean              : Read / Write

Whether or not to keep all text in a single paragraph.

Default value: FALSE

### The "`size`" property

      "size"                 gint                  : Read / Write

Font size.

Allowed values: >= 0

Default value: 0

### The "`size-points`" property

      "size-points"          gdouble               : Read / Write

Font size in points.

Allowed values: >= 0

Default value: 0

### The "`size-set`" property

      "size-set"             gboolean              : Read / Write

Whether this tag affects the font size.

Default value: FALSE

### The "`stretch`" property

      "stretch"              PangoStretch          : Read / Write

Font stretch.

Default value: PANGO_STRETCH_NORMAL

### The "`stretch-set`" property

      "stretch-set"          gboolean              : Read / Write

Whether this tag affects the font stretch.

Default value: FALSE

### The "`strikethrough`" property

      "strikethrough"        gboolean              : Read / Write

Whether to strike through the text.

Default value: FALSE

### The "`strikethrough-set`" property

      "strikethrough-set"    gboolean              : Read / Write

Whether this tag affects strikethrough.

Default value: FALSE

### The "`style`" property

      "style"                PangoStyle            : Read / Write

Font style.

Default value: PANGO_STYLE_NORMAL

### The "`style-set`" property

      "style-set"            gboolean              : Read / Write

Whether this tag affects the font style.

Default value: FALSE

### The "`text`" property

      "text"                 gchararray            : Read / Write

Text to render.

Default value: NULL

### The "`underline`" property

      "underline"            PangoUnderline        : Read / Write

Style of underline for this text.

Default value: PANGO_UNDERLINE_NONE

### The "`underline-set`" property

      "underline-set"        gboolean              : Read / Write

Whether this tag affects underlining.

Default value: FALSE

### The "`variant`" property

      "variant"              PangoVariant          : Read / Write

Font variant.

Default value: PANGO_VARIANT_NORMAL

### The "`variant-set`" property

      "variant-set"          gboolean              : Read / Write

Whether this tag affects the font variant.

Default value: FALSE

### The "`weight`" property

      "weight"               gint                  : Read / Write

Font weight.

Allowed values: >= 0

Default value: 400

### The "`weight-set`" property

      "weight-set"           gboolean              : Read / Write

Whether this tag affects the font weight.

Default value: FALSE

## 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.