Description

Renders text in a cell

A Gnome::Gtk4::CellRendererText 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 Gnome::Gtk4::CellRendererText:ellipsize` property allows it.

If the Gnome::Gtk4::CellRenderer:mode` is GTK_CELL_RENDERER_MODE_EDITABLE, the Gnome::Gtk4::CellRendererText allows to edit its text using an entry.

Class initialization

Note: The native version of this class is deprecated in gtk4-lib() since version 4.10

new

:native-object

Create an object using a native object from elsewhere. See also Gnome::N::TopLevelSupportClass.

multi method new ( N-Object :$native-object! )

new-cellrenderertext

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Creates a new Gnome::Gtk4::CellRendererText. Adjust how text is drawn using object properties. Object properties can be set globally (with g_object_set()). Also, with Gnome::Gtk4::TreeViewColumn, you can bind a property to a value in a Gnome::Gtk4::R-TreeModel. 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 Gnome::Gtk4::TreeView.

method new-cellrenderertext ( --> Gnome::Gtk4::CellRendererText \)

Methods

set-fixed-height-from-font

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

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 inflexible, 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.

method set-fixed-height-from-font ( Int() $number-of-rows )

• $number-of-rows; Number of rows of text each cell renderer is allocated, or -1.

Signals

edited

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.

method handler (
  Str $path,
  Str $new-text,
  Int :$_handle_id,
  N-GObject :$_native-object,
  Gnome::Gtk4::CellRendererText :$_widget,
  *C<user>-options
)

• $path; the path identifying the edited cell.

• $new-text; the new text.

• $_handle_id; The registered event handler id.

• $_native-object; The native object provided by the Raku object which registered this event. This a native Gnome::Gtk4::CellRendererText object.

• $_widget; The object which registered the signal. User code may have left the object going out of scope.

• user-options; A list of named arguments provided at the .register-signal() method from Gnome::GObject::Object.