GTK+ Reference Manual
<<< Previous PageHomeUpNext 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 PageHomeUpNext Page >>>
GtkCellRendererPixbufGtkCellRendererToggle