Class
GtkCellRendererText
Description [src]
class Gtk.CellRendererText : Gtk.CellRenderer
{
/* No available fields */
}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 GtkCellRendererText:ellipsize property allows it.
If the GtkCellRenderer:mode is GTK_CELL_RENDERER_MODE_EDITABLE,
the GtkCellRendererText allows to edit its text using an entry.
Constructors
gtk_cell_renderer_text_new
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.
Instance methods
gtk_cell_renderer_text_set_fixed_height_from_font
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.
Methods inherited from GtkCellRenderer (24)
Please see GtkCellRenderer for a full list of methods.
Properties
Gtk.CellRendererText:alignment
Specifies how to align the lines of text with respect to each other.
since: 2.10
Gtk.CellRendererText:ellipsize
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.
since: 2.6
Gtk.CellRendererText:max-width-chars
The desired maximum width of the cell, in characters. If this property is set to -1, the width will be calculated automatically.
since: 3.0
Gtk.CellRendererText:placeholder-text
The text that will be displayed in the GtkCellRenderer if
GtkCellRendererText:editable is TRUE and the cell is empty.
Gtk.CellRendererText:width-chars
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.
since: 2.6
Gtk.CellRendererText:wrap-mode
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.
since: 2.8
Gtk.CellRendererText:wrap-width
Specifies the minimum 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.
since: 2.8
Properties inherited from GtkCellRenderer (16)
Gtk.CellRenderer:cell-background
Gtk.CellRenderer:cell-background-gdk
Cell background as a GdkColor.
deprecated: 3.4
Gtk.CellRenderer:cell-background-rgba
Cell background as a GdkRGBA.
since: 3.0
Gtk.CellRenderer:cell-background-set
Gtk.CellRenderer:editing
Gtk.CellRenderer:height
Gtk.CellRenderer:is-expanded
Gtk.CellRenderer:is-expander
Gtk.CellRenderer:mode
Gtk.CellRenderer:sensitive
Gtk.CellRenderer:visible
Gtk.CellRenderer:width
Gtk.CellRenderer:xalign
Gtk.CellRenderer:xpad
Gtk.CellRenderer:yalign
Gtk.CellRenderer:ypad
Signals
Signals inherited from GtkCellRenderer (2)
GtkCellRenderer::editing-canceled
This signal gets emitted when the user cancels the process of editing a cell. For example, an editable cell renderer could be written to cancel editing when the user presses Escape.
since: 2.4
GtkCellRenderer::editing-started
This signal gets emitted when a cell starts to be edited.
The intended use of this signal is to do special setup
on editable, e.g. adding a GtkEntryCompletion or setting
up additional columns in a GtkComboBox.
since: 2.6
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.
Class structure
struct GtkCellRendererTextClass {
GtkCellRendererClass parent_class;
void (* edited) (
GtkCellRendererText* cell_renderer_text,
const gchar* path,
const gchar* new_text
);
void (* _gtk_reserved1) (
void
);
void (* _gtk_reserved2) (
void
);
void (* _gtk_reserved3) (
void
);
void (* _gtk_reserved4) (
void
);
}No description available.
Class members
parent_class: GtkCellRendererClassNo description available.
edited: void (* edited) ( GtkCellRendererText* cell_renderer_text, const gchar* path, const gchar* new_text )No description available.
_gtk_reserved1: void (* _gtk_reserved1) ( void )No description available.
_gtk_reserved2: void (* _gtk_reserved2) ( void )No description available.
_gtk_reserved3: void (* _gtk_reserved3) ( void )No description available.
_gtk_reserved4: void (* _gtk_reserved4) ( void )No description available.