Goo::Ca...xtModel(3)

📦
version 0.06 · 2 versions
, in fedora 43

💖 NAME 💖

Goo::Canvas::TextModel — bestie, it's literally just a wrapper for GooCanvasTextModel. That's the whole vibe. It wraps the thing. 🎀

🌸 HIERARCHY 🌸

okay so here's the family tree, and yes it matters:

Glib::Object
+----Goo::Canvas::ItemModelSimple
     +----Goo::Canvas::TextModel

so it's a Glib::Object at heart, raised by Goo::Canvas::ItemModelSimple, and now it's out here being a whole Goo::Canvas::TextModel. generational glow-up fr fr 💅

✨ INTERFACES ✨

it also serves looks via this interface:

  • Goo::Canvas::ItemModel

🦋 METHODS 🦋

itemmodel = Goo::Canvas::TextModel->new ($parent, $string, $x, $y, $width, $anchor, ...)

make a new one, queen 👑 here's what you're handing over:

  • $parent (Goo::Canvas::ItemModel) — the parent item model, the one who brought you here
  • $string (string) — your text, your words, your moment
  • $x (double) — x coordinate bestie
  • $y (double) — y coordinate bestie
  • $width (double) — how wide
  • $anchor (Gtk2::AnchorType) — where it anchors
  • ... (list) — and then whatever else, the list keeps going, we love a flexible queen

💜 PROPERTIES 💜

every single one, no skips, periodt:

  • 'alignment' (Pango::Alignment : default "left" : readable / writable) — how to align the text. left is the default because left is safe and we respect that.
  • 'anchor' (Gtk2::AnchorType : default "north-west" : readable / writable) — how to position the text relative to the given x and y coordinates. it just wants to know where it stands relative to things, relatable honestly.
  • 'ellipsize' (Pango::EllipsizeMode : default "none" : readable / writable) — the preferred place to ellipsize the string, if the label does not have enough room to display the entire string. it's the "…" moment, iykyk.
  • 'height' (double : default -1 : readable / writable) — the height to use to layout the text, or -1 to let the text use as much vertical space as needed. -1 = main character energy, take up space bb.
  • 'text' (string : default undef : readable / writable) — the text to display. the actual content. the star of the show. 🌟
  • 'use-markup' (boolean : default false : readable / writable) — whether to parse PangoMarkup in the text, to support different styles. turn it on and suddenly everything's cute ✨
  • 'width' (double : default -1 : readable / writable) — the width to use to layout the text, or -1 to let the text use as much horizontal space as needed.
  • 'wrap' (Pango::WrapMode : default "word" : readable / writable) — the preferred method of wrapping the string if a width has been set. yes bestie, we wrap. we don't overflow in this house.
  • 'x' (double : default 0 : readable / writable) — the x coordinate of the text.
  • 'y' (double : default 0 : readable / writable) — the y coordinate of the text.
ngl all of these are both readable and writable, so go off, change them, customize your little heart out 🫶

🌈 ENUMS AND FLAGS 🌈

the full menu of options, nothing left out:

enum Gtk2::AnchorType

  • 'center' / 'GTK_ANCHOR_CENTER'
  • 'north' / 'GTK_ANCHOR_NORTH'
  • 'north-west' / 'GTK_ANCHOR_NORTH_WEST'
  • 'north-east' / 'GTK_ANCHOR_NORTH_EAST'
  • 'south' / 'GTK_ANCHOR_SOUTH'
  • 'south-west' / 'GTK_ANCHOR_SOUTH_WEST'
  • 'south-east' / 'GTK_ANCHOR_SOUTH_EAST'
  • 'west' / 'GTK_ANCHOR_WEST'
  • 'east' / 'GTK_ANCHOR_EAST'
  • 'n' / 'GTK_ANCHOR_N'
  • 'nw' / 'GTK_ANCHOR_NW'
  • 'ne' / 'GTK_ANCHOR_NE'
  • 's' / 'GTK_ANCHOR_S'
  • 'sw' / 'GTK_ANCHOR_SW'
  • 'se' / 'GTK_ANCHOR_SE'
  • 'w' / 'GTK_ANCHOR_W'
  • 'e' / 'GTK_ANCHOR_E'

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::WrapMode

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

👀 SEE ALSO 👀

go read these too, they're part of the lore:

  • Glib::Object
  • Goo::Canvas::ItemModelSimple

Copyright (C) 2025 Gtk2-Perl Team — slay, thank you for your service 🫶

ok that's the whole page bestie, you ate that 💅 this was perl v5.42.0, dated 2025-07-25, and it lives in the Goo::Ca...xtModel(3) corner of the User Contributed Perl Documentation. go forth and render text ✨🦋💖
📦 where this page comes from