![]() | ![]() | ![]() | GTK+ Reference Manual | ![]() |
---|
GtkCellRendererTextGtkCellRendererText — Renders text in a cell |
#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);
"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
"edited" void user_function (GtkCellRendererText *cellrenderertext, gchar *arg1, gchar *arg2, gpointer user_data);
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 |
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 |
"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.
Default value: NULL
"background-gdk" GdkColor : Read / Write
Background color as a GdkColor.
"background-set" gboolean : Read / Write
Whether this tag affects the background color.
Default value: FALSE
"editable" gboolean : Read / Write
Whether the text can be modified by the user.
Default value: FALSE
"editable-set" gboolean : Read / Write
Whether this tag affects text editability.
Default value: FALSE
"family" gchararray : Read / Write
Name of the font family, e.g. Sans, Helvetica, Times, Monospace.
Default value: NULL
"family-set" gboolean : Read / Write
Whether this tag affects the font family.
Default value: FALSE
"font" gchararray : Read / Write
Font description as a string.
Default value: NULL
"font-desc" PangoFontDescription : Read / Write
Font description as a PangoFontDescription struct.
"foreground" gchararray : Write
Foreground color as a string.
Default value: NULL
"foreground-gdk" GdkColor : Read / Write
Foreground color as a GdkColor.
"foreground-set" gboolean : Read / Write
Whether this tag affects the foreground color.
Default value: FALSE
"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
"language-set" gboolean : Read / Write
Whether this tag affects the language the text is rendered as.
Default value: FALSE
"rise" gint : Read / Write
Offset of text above the baseline (below the baseline if rise is negative).
Allowed values: >= -2147483647
Default value: 0
"rise-set" gboolean : Read / Write
Whether this tag affects the rise.
Default value: FALSE
"scale" gdouble : Read / Write
Font scaling factor.
Allowed values: >= 0
Default value: 1
"scale-set" gboolean : Read / Write
Whether this tag scales the font size by a factor.
Default value: FALSE
"single-paragraph-mode" gboolean : Read / Write
Whether or not to keep all text in a single paragraph.
Default value: FALSE
"size-points" gdouble : Read / Write
Font size in points.
Allowed values: >= 0
Default value: 0
"size-set" gboolean : Read / Write
Whether this tag affects the font size.
Default value: FALSE
"stretch" PangoStretch : Read / Write
Font stretch.
Default value: PANGO_STRETCH_NORMAL
"stretch-set" gboolean : Read / Write
Whether this tag affects the font stretch.
Default value: FALSE
"strikethrough" gboolean : Read / Write
Whether to strike through the text.
Default value: FALSE
"strikethrough-set" gboolean : Read / Write
Whether this tag affects strikethrough.
Default value: FALSE
"style-set" gboolean : Read / Write
Whether this tag affects the font style.
Default value: FALSE
"underline" PangoUnderline : Read / Write
Style of underline for this text.
Default value: PANGO_UNDERLINE_NONE
"underline-set" gboolean : Read / Write
Whether this tag affects underlining.
Default value: FALSE
"variant" PangoVariant : Read / Write
Font variant.
Default value: PANGO_VARIANT_NORMAL
"variant-set" gboolean : Read / Write
Whether this tag affects the font variant.
Default value: FALSE
"weight" gint : Read / Write
Font weight.
Allowed values: >= 0
Default value: 400
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. |
<< GtkCellRendererPixbuf | GtkCellRendererToggle >> |