Struct gtk4::CellRendererText

#[repr(transparent)]
pub struct CellRendererText { /* private fields */ }

List views use widgets to display their contents. You should use Inscription or Label instead Renders text in a cell

A 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 GtkCellRendererText:ellipsize property allows it.

If the GtkCellRenderer:mode is CellRendererMode::Editable, the CellRendererText allows to edit its text using an entry.

Properties

align-set

Readable | Writeable

alignment

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 CellRenderer, on the other hand, sets the horizontal alignment of the whole text.

Readable | Writeable

attributes

Readable | Writeable

background

Writeable

background-rgba

Background color as a gdk::RGBA

Readable | Writeable

background-set

Readable | Writeable

editable

Readable | Writeable

editable-set

Readable | Writeable

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::EllipsizeMode::None turns off ellipsizing. See the wrap-width property for another way of making the text fit into a given width.

Readable | Writeable

ellipsize-set

Readable | Writeable

family

Readable | Writeable

family-set

Readable | Writeable

font

Readable | Writeable

font-desc

Readable | Writeable

foreground

Writeable

foreground-rgba

Foreground color as a gdk::RGBA

Readable | Writeable

foreground-set

Readable | Writeable

language

Readable | Writeable

language-set

Readable | Writeable

markup

Writeable

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.

For cell renderers that ellipsize or wrap text; this property controls the maximum reported width of the cell. The cell should not receive any greater allocation unless it is set to expand in its CellLayout and all of the cell’s siblings have received their natural width.

Readable | Writeable

placeholder-text

The text that will be displayed in the CellRenderer if GtkCellRendererText:editable is true and the cell is empty.

Readable | Writeable

rise

Readable | Writeable

rise-set

Readable | Writeable

scale

Readable | Writeable

scale-set

Readable | Writeable

single-paragraph-mode

Readable | Writeable

size

Readable | Writeable

size-points

Readable | Writeable

size-set

Readable | Writeable

stretch

Readable | Writeable

stretch-set

Readable | Writeable

strikethrough

Readable | Writeable

strikethrough-set

Readable | Writeable

style

Readable | Writeable

style-set

Readable | Writeable

text

Readable | Writeable

underline

Readable | Writeable

underline-set

Readable | Writeable

variant

Readable | Writeable

variant-set

Readable | Writeable

weight

Readable | Writeable

weight-set

Readable | Writeable

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.

Readable | Writeable

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.

Readable | Writeable

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.

Readable | Writeable

CellRenderer

cell-background

Writeable

cell-background-rgba

Cell background as a gdk::RGBA

Readable | Writeable

cell-background-set

Readable | Writeable

editing

Readable

height

Readable | Writeable

is-expanded

Readable | Writeable

is-expander

Readable | Writeable

mode

Readable | Writeable

sensitive

Readable | Writeable

visible

Readable | Writeable

width

Readable | Writeable

xalign

Readable | Writeable

xpad

Readable | Writeable

yalign

Readable | Writeable

ypad

Readable | Writeable

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.

CellRenderer

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.

See also: gtk_cell_renderer_stop_editing().

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 EntryCompletion or setting up additional columns in a ComboBox.

See gtk_cell_editable_start_editing() for information on the lifecycle of the @editable and a way to do setup that doesn’t depend on the @renderer.

Note that GTK doesn’t guarantee that cell renderers will continue to use the same kind of widget for editing in future releases, therefore you should check the type of @editable before doing any specific setup, as in the following example:

⚠️ The following code is in C ⚠️

static void
text_editing_started (GtkCellRenderer *cell,
                      GtkCellEditable *editable,
                      const char      *path,
                      gpointer         data)
{
  if (GTK_IS_ENTRY (editable))
    {
      GtkEntry *entry = GTK_ENTRY (editable);

      // ... create a GtkEntryCompletion

      gtk_entry_set_completion (entry, completion);
    }
}

Implements

CellRendererTextExt, CellRendererExt, glib::ObjectExt, [CellRendererExtManual][trait@crate::prelude::CellRendererExtManual]

Implementations

impl CellRendererText

pub const NONE: Option<&'static CellRendererText> = None

pub fn new() -> CellRendererText

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

Deprecated since 4.10

Returns

the new cell renderer

pub fn builder() -> CellRendererTextBuilder

Creates a new builder-pattern struct instance to construct CellRendererText objects.

This method returns an instance of CellRendererTextBuilder which can be used to create CellRendererText objects.

Trait Implementations

impl Clone for CellRendererText

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CellRendererText

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CellRendererText

fn default() -> Self

Returns the “default value” for a type.

impl Display for CellRendererText

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for CellRendererText

type ParamSpec = ParamSpecObject

type SetValue = CellRendererText

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, CellRendererText>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for CellRendererText

fn hash<H>(&self, state: &mut H)where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<T: CellRendererTextImpl> IsSubclassable<T> for CellRendererText

fn class_init(class: &mut Class<Self>)

Override the virtual methods of this class for the given subclass and do other class initialization.

fn instance_init(instance: &mut InitializingObject<T>)

Instance specific initialization.

impl Ord for CellRendererText

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for CellRendererText

type Parent = CellRenderer

impl<OT: ObjectType> PartialEq<OT> for CellRendererText

fn eq(&self, other: &OT) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for CellRendererText

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for CellRendererText

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for CellRendererText

impl IsA<CellRenderer> for CellRendererText

impl IsA<CellRendererText> for CellRendererAccel

impl IsA<CellRendererText> for CellRendererCombo

impl IsA<CellRendererText> for CellRendererSpin