GTK+ Reference Manual
<<< Previous Page | Home | Up | Next Page >>>

# GtkCellRendererText

## Name

GtkCellRendererText --

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

      "text"                 gchararray           : Read / Write
      "markup"               gchararray           : Write
      "attributes"           PangoAttrList        : Read / Write
      "background"           gchararray           : Write
      "foreground"           gchararray           : Write
      "background-gdk"       GdkColor             : Read / Write
      "foreground-gdk"       GdkColor             : Read / Write
      "font"                 gchararray           : Read / Write
      "font-desc"            PangoFontDescription : Read / Write
      "family"               gchararray           : Read / Write
      "style"                PangoStyle           : Read / Write
      "variant"              PangoVariant         : Read / Write
      "weight"               gint                 : Read / Write
      "stretch"              PangoStretch         : Read / Write
      "size"                 gint                 : Read / Write
      "size-points"          gdouble              : Read / Write
      "scale"                gdouble              : Read / Write
      "editable"             gboolean             : Read / Write
      "strikethrough"        gboolean             : Read / Write
      "underline"            PangoUnderline       : Read / Write
      "rise"                 gint                 : Read / Write
      "background-set"       gboolean             : Read / Write
      "foreground-set"       gboolean             : Read / Write
      "family-set"           gboolean             : Read / Write
      "style-set"            gboolean             : Read / Write
      "variant-set"          gboolean             : Read / Write
      "weight-set"           gboolean             : Read / Write
      "stretch-set"          gboolean             : Read / Write
      "size-set"             gboolean             : Read / Write
      "scale-set"            gboolean             : Read / Write
      "editable-set"         gboolean             : Read / Write
      "strikethrough-set"    gboolean             : Read / Write
      "underline-set"        gboolean             : Read / Write
      "rise-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

"`text`" (gchararray : Read / Write)

  Text to render

"`markup`" (gchararray : Write)

  Marked up text to render

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

"`foreground`" (gchararray : Write)

  Foreground color as a string

"`background-gdk`" (GdkColor : Read / Write)

  Background color as a GdkColor

"`foreground-gdk`" (GdkColor : Read / Write)

  Foreground color as a GdkColor

"`font`" (gchararray : Read / Write)

  Font description as a string

"`font-desc`" (PangoFontDescription : Read / Write)

  Font description as a PangoFontDescription struct

"`family`" (gchararray : Read / Write)

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

"`style`" (PangoStyle : Read / Write)

  Font style

"`variant`" (PangoVariant : Read / Write)

  Font variant

"`weight`" (gint : Read / Write)

  Font weight

"`stretch`" (PangoStretch : Read / Write)

  Font stretch

"`size`" (gint : Read / Write)

  Font size

"`size-points`" (gdouble : Read / Write)

  Font size in points

"`scale`" (gdouble : Read / Write)

  Font scaling factor

"`editable`" (gboolean : Read / Write)

  Whether the text can be modified by the user

"`strikethrough`" (gboolean : Read / Write)

  Whether to strike through the text

"`underline`" (PangoUnderline : Read / Write)

  Style of underline for this text

"`rise`" (gint : Read / Write)

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

"`background-set`" (gboolean : Read / Write)

  Whether this tag affects the background color

"`foreground-set`" (gboolean : Read / Write)

  Whether this tag affects the foreground color

"`family-set`" (gboolean : Read / Write)

  Whether this tag affects the font family

"`style-set`" (gboolean : Read / Write)

  Whether this tag affects the font style

"`variant-set`" (gboolean : Read / Write)

  Whether this tag affects the font variant

"`weight-set`" (gboolean : Read / Write)

  Whether this tag affects the font weight

"`stretch-set`" (gboolean : Read / Write)

  Whether this tag affects the font stretch

"`size-set`" (gboolean : Read / Write)

  Whether this tag affects the font size

"`scale-set`" (gboolean : Read / Write)

  Whether this tag scales the font size by a factor

"`editable-set`" (gboolean : Read / Write)

  Whether this tag affects text editability

"`strikethrough-set`" (gboolean : Read / Write)

  Whether this tag affects strikethrough

"`underline-set`" (gboolean : Read / Write)

  Whether this tag affects underlining

"`rise-set`" (gboolean : Read / Write)

  Whether this tag affects the rise

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

<<< Previous Page | Home | Up | Next Page >>>
GtkCellRendererPixbuf | GtkCellRendererToggle