Gtk2::C...rerText(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 Gtk2::CellRendererText 💖

okay bestie, gather round, because today we're talking about Gtk2::CellRendererText — the wrapper for GtkCellRendererText 🎀 that lives in the User Contributed Perl Documentation. Yeah it's one of those pages, but lowkey it's iconic.

✨ NAME ✨

Gtk2::CellRendererText — it's a wrapper for GtkCellRendererText. that's it, that's the whole vibe 🦋

🌸 HIERARCHY 🌸

the family tree, and yes she comes from a long line of distinguished ancestors:

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gtk2::CellRenderer
               +----Gtk2::CellRendererText

look at that lineage. main character energy from the very top 👑

💅 METHODS 💅

cellrenderer = Gtk2::CellRendererText->new

the classic. you make one, it exists, slay. periodt ✨

$renderer->set_fixed_height_from_font ($number_of_rows)

sets the fixed height from the font, using:

  • $number_of_rows (integer) — yeah it's an integer, don't overthink it 🍓

🦋 PROPERTIES 🦋

every single one, no skips, no cuts, fr fr. the format is type : default : flags and I am NOT trimming a single character of it 💜

  • 'align-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the alignment mode
  • 'alignment' — Pango::Alignment : default "left" : readable / writable / private / static-nick / static-blurb → How to align the lines
  • 'attributes' — Pango::AttrList : default undef : readable / writable / private / static-nick / static-blurb → A list of style attributes to apply to the text of the renderer
  • 'background' — string : default undef : writable / private / static-nick / static-blurb → Background color as a string
  • 'background-gdk' — Gtk2::Gdk::Color : default undef : readable / writable / private / static-nick / static-blurb → Background color as a GdkColor
  • 'background-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the background color
  • 'editable' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether the text can be modified by the user
  • 'editable-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects text editability
  • 'ellipsize' — Pango::EllipsizeMode : default "none" : readable / writable / private / static-nick / static-blurb → The preferred place to ellipsize the string, if the cell renderer does not have enough room to display the entire string
  • 'ellipsize-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the ellipsize mode
  • 'family' — string : default undef : readable / writable / private / static-nick / static-blurb → Name of the font family, e.g. Sans, Helvetica, Times, Monospace
  • 'family-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the font family
  • 'font' — string : default undef : readable / writable / private / static-nick / static-blurb → Font description as a string, e.g. "Sans Italic 12"
  • 'font-desc' — Pango::FontDescription : default undef : readable / writable / private / static-nick / static-blurb → Font description as a PangoFontDescription struct
  • 'foreground' — string : default undef : writable / private / static-nick / static-blurb → Foreground color as a string
  • 'foreground-gdk' — Gtk2::Gdk::Color : default undef : readable / writable / private / static-nick / static-blurb → Foreground color as a GdkColor
  • 'foreground-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the foreground color
  • 'language' — string : default undef : readable / writable / private / static-nick / static-blurb → 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
  • 'language-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the language the text is rendered as
  • 'markup' — string : default undef : writable / private / static-nick / static-blurb → Marked up text to render
  • 'rise' — integer : default 0 : readable / writable / private / static-nick / static-blurb → Offset of text above the baseline (below the baseline if rise is negative)
  • 'rise-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the rise
  • 'scale' — double : default 1 : readable / writable / private / static-nick / static-blurb → Font scaling factor
  • 'scale-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag scales the font size by a factor
  • 'single-paragraph-mode' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether or not to keep all text in a single paragraph
  • 'size' — integer : default 0 : readable / writable / private / static-nick / static-blurb → Font size
  • 'size-points' — double : default 0 : readable / writable / private / static-nick / static-blurb → Font size in points
  • 'size-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the font size
  • 'stretch' — Pango::Stretch : default "normal" : readable / writable / private / static-nick / static-blurb → Font stretch
  • 'stretch-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the font stretch
  • 'strikethrough' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether to strike through the text
  • 'strikethrough-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects strikethrough
  • 'style' — Pango::Style : default "normal" : readable / writable / private / static-nick / static-blurb → Font style
  • 'style-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the font style
  • 'text' — string : default undef : readable / writable / private / static-nick / static-blurb → Text to render
  • 'underline' — Pango::Underline : default "none" : readable / writable / private / static-nick / static-blurb → Style of underline for this text
  • 'underline-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects underlining
  • 'variant' — Pango::Variant : default "normal" : readable / writable / private / static-nick / static-blurb → Font variant
  • 'variant-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the font variant
  • 'weight' — integer : default 400 : readable / writable / private / static-nick / static-blurb → Font weight
  • 'weight-set' — boolean : default false : readable / writable / private / static-nick / static-blurb → Whether this tag affects the font weight
  • 'width-chars' — integer : default -1 : readable / writable / private / static-nick / static-blurb → The desired width of the label, in characters
  • 'wrap-mode' — Pango::WrapMode : default "char" : readable / writable / private / static-nick / static-blurb → How to break the string into multiple lines, if the cell renderer does not have enough room to display the entire string
  • 'wrap-width' — integer : default -1 : readable / writable / private / static-nick / static-blurb → The width at which the text is wrapped
not me listing every single one 💀 but like, they ALL matter, okay?? no cap.

🔥 SIGNALS 🔥

  • edited (Gtk2::CellRendererText, string, string)

🌈 ENUMS AND FLAGS 🌈

enum Pango::Alignment

  • 'left' / 'PANGO_ALIGN_LEFT'
  • 'center' / 'PANGO_ALIGN_CENTER'
  • 'right' / 'PANGO_ALIGN_RIGHT'

enum Pango::EllipsizeMode

  • 'none' / 'PANGO_ELLIPSIZE_NONE'
  • 'start' / 'PANGO_ELLIPSIZE_START'
  • 'middle' / 'PANGO_ELLIPSIZE_MIDDLE'
  • 'end' / 'PANGO_ELLIPSIZE_END'

enum Pango::Stretch

  • 'ultra-condensed' / 'PANGO_STRETCH_ULTRA_CONDENSED'
  • 'extra-condensed' / 'PANGO_STRETCH_EXTRA_CONDENSED'
  • 'condensed' / 'PANGO_STRETCH_CONDENSED'
  • 'semi-condensed' / 'PANGO_STRETCH_SEMI_CONDENSED'
  • 'normal' / 'PANGO_STRETCH_NORMAL'
  • 'semi-expanded' / 'PANGO_STRETCH_SEMI_EXPANDED'
  • 'expanded' / 'PANGO_STRETCH_EXPANDED'
  • 'extra-expanded' / 'PANGO_STRETCH_EXTRA_EXPANDED'
  • 'ultra-expanded' / 'PANGO_STRETCH_ULTRA_EXPANDED'

enum Pango::Style

  • 'normal' / 'PANGO_STYLE_NORMAL'
  • 'oblique' / 'PANGO_STYLE_OBLIQUE'
  • 'italic' / 'PANGO_STYLE_ITALIC'

enum Pango::Underline

  • 'none' / 'PANGO_UNDERLINE_NONE'
  • 'single' / 'PANGO_UNDERLINE_SINGLE'
  • 'double' / 'PANGO_UNDERLINE_DOUBLE'
  • 'low' / 'PANGO_UNDERLINE_LOW'
  • 'error' / 'PANGO_UNDERLINE_ERROR'
  • 'single-line' / 'PANGO_UNDERLINE_SINGLE_LINE'
  • 'double-line' / 'PANGO_UNDERLINE_DOUBLE_LINE'
  • 'error-line' / 'PANGO_UNDERLINE_ERROR_LINE'

enum Pango::Variant

  • 'normal' / 'PANGO_VARIANT_NORMAL'
  • 'small-caps' / 'PANGO_VARIANT_SMALL_CAPS'
  • 'all-small-caps' / 'PANGO_VARIANT_ALL_SMALL_CAPS'
  • 'petite-caps' / 'PANGO_VARIANT_PETITE_CAPS'
  • 'all-petite-caps' / 'PANGO_VARIANT_ALL_PETITE_CAPS'
  • 'unicase' / 'PANGO_VARIANT_UNICASE'
  • 'title-caps' / 'PANGO_VARIANT_TITLE_CAPS'

enum Pango::WrapMode

  • 'word' / 'PANGO_WRAP_WORD'
  • 'char' / 'PANGO_WRAP_CHAR'
  • 'word-char' / 'PANGO_WRAP_WORD_CHAR'
  • 'none' / 'PANGO_WRAP_NONE'

🫶 SEE ALSO 🫶

go read these next, they're the whole friend group:

  • Gtk2
  • Glib::Object
  • Glib::InitiallyUnowned
  • Gtk2::Object
  • Gtk2::CellRenderer

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.

and that's the page, bestie 💖 this was Gtk2::C...rerText(3) from perl v5.42.0, dated 2025-07-25 — go forth and render some text, you absolute icon 🌟

📦 where this page comes from