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.