---
name: "Gtk2::CellRendererText"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::CellRendererText"
---

# Gtk2::CellRendererText(3pm)

wrapper for GtkCellRendererText

## NAME

Gtk2::CellRendererText - wrapper for GtkCellRendererText

## HIERARCHY

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

## METHODS

### cellrenderer = Gtk2::CellRendererText-\>new

### $renderer-\>set\_fixed\_height\_from\_font ($number\_of\_rows)

- •

  `$number_of_rows` (integer)

## PROPERTIES

- 'align-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the alignment mode

- 'alignment' (Pango::Alignment : default "left" : readable / writable / private)

  How to align the lines

- 'attributes' (Pango::AttrList : default undef : readable / writable / private)

  A list of style attributes to apply to the text of the renderer

- 'background' (string : default undef : writable / private)

  Background color as a string

- 'background-gdk' (Gtk2::Gdk::Color : default undef : readable / writable / private)

  Background color as a GdkColor

- 'background-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the background color

- 'editable' (boolean : default false : readable / writable / private)

  Whether the text can be modified by the user

- 'editable-set' (boolean : default false : readable / writable / private)

  Whether this tag affects text editability

- 'ellipsize' (Pango::EllipsizeMode : default "none" : readable / writable / private)

  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)

  Whether this tag affects the ellipsize mode

- 'family' (string : default undef : readable / writable / private)

  Name of the font family, e.g. Sans, Helvetica, Times, Monospace

- 'family-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the font family

- 'font' (string : default undef : readable / writable / private)

  Font description as a string, e.g. "Sans Italic 12"

- 'font-desc' (Pango::FontDescription : default undef : readable / writable / private)

  Font description as a PangoFontDescription struct

- 'foreground' (string : default undef : writable / private)

  Foreground color as a string

- 'foreground-gdk' (Gtk2::Gdk::Color : default undef : readable / writable / private)

  Foreground color as a GdkColor

- 'foreground-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the foreground color

- 'language' (string : default undef : readable / writable / private)

  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)

  Whether this tag affects the language the text is rendered as

- 'markup' (string : default undef : writable / private)

  Marked up text to render

- 'rise' (integer : default 0 : readable / writable / private)

  Offset of text above the baseline (below the baseline if rise is negative)

- 'rise-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the rise

- 'scale' (double : default 1 : readable / writable / private)

  Font scaling factor

- 'scale-set' (boolean : default false : readable / writable / private)

  Whether this tag scales the font size by a factor

- 'single-paragraph-mode' (boolean : default false : readable / writable / private)

  Whether or not to keep all text in a single paragraph

- 'size' (integer : default 0 : readable / writable / private)

  Font size

- 'size-points' (double : default 0 : readable / writable / private)

  Font size in points

- 'size-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the font size

- 'stretch' (Pango::Stretch : default "normal" : readable / writable / private)

  Font stretch

- 'stretch-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the font stretch

- 'strikethrough' (boolean : default false : readable / writable / private)

  Whether to strike through the text

- 'strikethrough-set' (boolean : default false : readable / writable / private)

  Whether this tag affects strikethrough

- 'style' (Pango::Style : default "normal" : readable / writable / private)

  Font style

- 'style-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the font style

- 'text' (string : default undef : readable / writable / private)

  Text to render

- 'underline' (Pango::Underline : default "none" : readable / writable / private)

  Style of underline for this text

- 'underline-set' (boolean : default false : readable / writable / private)

  Whether this tag affects underlining

- 'variant' (Pango::Variant : default "normal" : readable / writable / private)

  Font variant

- 'variant-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the font variant

- 'weight' (integer : default 400 : readable / writable / private)

  Font weight

- 'weight-set' (boolean : default false : readable / writable / private)

  Whether this tag affects the font weight

- 'width-chars' (integer : default -1 : readable / writable / private)

  The desired width of the label, in characters

- 'wrap-mode' (Pango::WrapMode : default "char" : readable / writable / private)

  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)

  The width at which the text is wrapped

## 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'

### enum Pango::Variant

- •

  'normal' / 'PANGO\_VARIANT\_NORMAL'

- •

  'small-caps' / 'PANGO\_VARIANT\_SMALL\_CAPS'

### enum Pango::WrapMode

- •

  'word' / 'PANGO\_WRAP\_WORD'

- •

  'char' / 'PANGO\_WRAP\_CHAR'

- •

  'word-char' / 'PANGO\_WRAP\_WORD\_CHAR'

## SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::CellRenderer

## COPYRIGHT

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

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