![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkCellRendererText; GtkCellRenderer* gtk_cell_renderer_text_new (void); void gtk_cell_renderer_text_set_fixed_height_from_font (GtkCellRendererText *renderer, gint number_of_rows);
GObject +----GInitiallyUnowned +----GtkObject +----GtkCellRenderer +----GtkCellRendererText +----GtkCellRendererAccel +----GtkCellRendererCombo +----GtkCellRendererSpin
align-set gboolean : Read / Write alignment PangoAlignment : Read / Write 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 ellipsize PangoEllipsizeMode : Read / Write ellipsize-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 width-chars gint : Read / Write wrap-mode PangoWrapMode : Read / Write wrap-width gint : Read / Write
A GtkCellRendererText renders a given text in its cell, using the font, color and style information provided by its properties. The text will be ellipsized if it is too long and the ellipsize property allows it.
If the mode is GTK_CELL_RENDERER_MODE_EDITABLE
,
the GtkCellRendererText allows to edit its text using an entry.
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 |
align-set
propertyalign-set gboolean : Read / Write
Whether this tag affects the alignment mode.
Default value: FALSE
alignment
propertyalignment PangoAlignment : Read / Write
Specifies how to align the lines of text with respect to each other.
Note that this property describes how to align the lines of text in case there are several of them. The "xalign" property of GtkCellRenderer, on the other hand, sets the horizontal alignment of the whole text.
Default value: PANGO_ALIGN_LEFT
Since 2.10
attributes
propertyattributes PangoAttrList : Read / Write
A list of style attributes to apply to the text of the renderer.
background
propertybackground gchararray : Write
Background color as a string.
Default value: NULL
background-set
propertybackground-set gboolean : Read / Write
Whether this tag affects the background color.
Default value: FALSE
editable
propertyeditable gboolean : Read / Write
Whether the text can be modified by the user.
Default value: FALSE
editable-set
propertyeditable-set gboolean : Read / Write
Whether this tag affects text editability.
Default value: FALSE
ellipsize
propertyellipsize PangoEllipsizeMode : Read / Write
Specifies the preferred place to ellipsize the string, if the cell renderer
does not have enough room to display the entire string. Setting it to
PANGO_ELLIPSIZE_NONE
turns off ellipsizing. See the wrap-width property
for another way of making the text fit into a given width.
Default value: PANGO_ELLIPSIZE_NONE
Since 2.6
ellipsize-set
propertyellipsize-set gboolean : Read / Write
Whether this tag affects the ellipsize mode.
Default value: FALSE
family
propertyfamily gchararray : Read / Write
Name of the font family, e.g. Sans, Helvetica, Times, Monospace.
Default value: NULL
family-set
propertyfamily-set gboolean : Read / Write
Whether this tag affects the font family.
Default value: FALSE
font
propertyfont gchararray : Read / Write
Font description as a string, e.g. "Sans Italic 12".
Default value: NULL
font-desc
propertyfont-desc PangoFontDescription : Read / Write
Font description as a PangoFontDescription struct.
foreground
propertyforeground gchararray : Write
Foreground color as a string.
Default value: NULL
foreground-set
propertyforeground-set gboolean : Read / Write
Whether this tag affects the foreground color.
Default value: FALSE
language
propertylanguage 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
propertylanguage-set gboolean : Read / Write
Whether this tag affects the language the text is rendered as.
Default value: FALSE
rise
propertyrise gint : Read / Write
Offset of text above the baseline (below the baseline if rise is negative).
Allowed values: >= -2147483647
Default value: 0
rise-set
propertyrise-set gboolean : Read / Write
Whether this tag affects the rise.
Default value: FALSE
scale
propertyscale gdouble : Read / Write
Font scaling factor.
Allowed values: >= 0
Default value: 1
scale-set
propertyscale-set gboolean : Read / Write
Whether this tag scales the font size by a factor.
Default value: FALSE
single-paragraph-mode
propertysingle-paragraph-mode gboolean : Read / Write
Whether or not to keep all text in a single paragraph.
Default value: FALSE
size-points
propertysize-points gdouble : Read / Write
Font size in points.
Allowed values: >= 0
Default value: 0
size-set
propertysize-set gboolean : Read / Write
Whether this tag affects the font size.
Default value: FALSE
stretch
propertystretch PangoStretch : Read / Write
Font stretch.
Default value: PANGO_STRETCH_NORMAL
stretch-set
propertystretch-set gboolean : Read / Write
Whether this tag affects the font stretch.
Default value: FALSE
strikethrough
propertystrikethrough gboolean : Read / Write
Whether to strike through the text.
Default value: FALSE
strikethrough-set
propertystrikethrough-set gboolean : Read / Write
Whether this tag affects strikethrough.
Default value: FALSE
style-set
propertystyle-set gboolean : Read / Write
Whether this tag affects the font style.
Default value: FALSE
underline
propertyunderline PangoUnderline : Read / Write
Style of underline for this text.
Default value: PANGO_UNDERLINE_NONE
underline-set
propertyunderline-set gboolean : Read / Write
Whether this tag affects underlining.
Default value: FALSE
variant
propertyvariant PangoVariant : Read / Write
Font variant.
Default value: PANGO_VARIANT_NORMAL
variant-set
propertyvariant-set gboolean : Read / Write
Whether this tag affects the font variant.
Default value: FALSE
weight
propertyweight gint : Read / Write
Font weight.
Allowed values: >= 0
Default value: 400
weight-set
propertyweight-set gboolean : Read / Write
Whether this tag affects the font weight.
Default value: FALSE
width-chars
propertywidth-chars gint : Read / Write
The desired width of the cell, in characters. If this property is set to -1, the width will be calculated automatically, otherwise the cell will request either 3 characters or the property value, whichever is greater.
Allowed values: >= -1
Default value: -1
Since 2.6
wrap-mode
propertywrap-mode PangoWrapMode : Read / Write
Specifies how to break the string into multiple lines, if the cell renderer does not have enough room to display the entire string. This property has no effect unless the wrap-width property is set.
Default value: PANGO_WRAP_CHAR
Since 2.8
wrap-width
propertywrap-width gint : Read / Write
Specifies the width at which the text is wrapped. The wrap-mode property can be used to influence at what character positions the line breaks can be placed. Setting wrap-width to -1 turns wrapping off.
Allowed values: >= -1
Default value: -1
Since 2.8
::edited
signalvoid user_function (GtkCellRendererText *renderer, gchar *path, gchar *new_text, gpointer user_data) : Run Last
This signal is emitted after renderer
has been edited.
It is the responsibility of the application to update the model
and store new_text
at the position indicated by path
.
renderer : |
the object which received the signal |
path : |
the path identifying the edited cell |
new_text : |
the new text |
user_data : |
user data set when the signal handler was connected. |