Gnome2:...ichText(3)

📦
version 1.006 · 2 versions
, in fedora 43

🦋 Gnome2::Canvas::RichText 🦋

okay so bestie, welcome to the Gnome2:...ichText(3) page 💖 it lives in the User Contributed Perl Documentation corner of the perl-verse, and it's serving pure canvas-text energy. This is the wrapper for GnomeCanvasRichText — like, a text item that lives on a Gnome2::Canvas and is fully editable. it's giving main character typography. periodt. ✨

✨ NAME ✨

Gnome2::Canvas::RichText — wrapper for GnomeCanvasRichText 💅

🌈 HIERARCHY 🌈

here's the family tree, bestie, and yes we're the youngest sibling at the bottom, thriving:

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gnome2::Canvas::Item
               +----Gnome2::Canvas::RichText

so it's Glib::Object → Glib::InitiallyUnowned → Gtk2::Object → Gnome2::Canvas::Item → us 👑 we inherited everything, no cap.

💅 METHODS 💅

okay the methods, let's go, one by one, no skipping, that's the rule 🫶

  • textbuffer = $text->get_buffer — hand over the text buffer please 📥
  • $text->set_buffer ($buffer) — set the buffer, and here's the tea:
    • $buffer (Gtk2::TextBuffer)
  • $text->copy_clipboard — copy the selection to the clipboard, iconic behavior ✂️✨
  • $text->cut_clipboard — cut it. gone. into the clipboard it goes 💀
  • textiter = $text->get_iter_at_location ($x, $y) — get the text iter at a spot, so you know exactly what's where 🔍
    • $x (integer)
    • $y (integer)
  • rectangle = $text->get_iter_location ($iter) — get the rectangle where that iter lives 📐
    • $iter (Gtk2::TextIter)
  • $text->paste_clipboard — paste what you copied, the cycle continues 🌀

🎀 PROPERTIES 🎀

twenty of them. TWENTY. we're not skipping a single one, bestie, every default is staying exactly where it is 💖

  • 'anchor' (Gtk2::AnchorType : default "north-west" : readable / writable) — anchor point for text, like where the text anchors itself, vibe-wise ⚓
  • 'cursor-blink' (boolean : default true : readable / writable) — does the cursor blink in this rich text item? blink blink blink 👁️
  • 'cursor-visible' (boolean : default true : readable / writable) — is the cursor visible in this rich text item? don't hide it, it's shy
  • 'direction' (Gtk2::DirectionType : default "tab-backward" : readable / writable) — text direction, which way we're heading 🧭
  • 'editable' (boolean : default true : readable / writable) — is this rich text item editable? by default yes, go off ✍️
  • 'grow-height' (boolean : default false : readable / writable) — should the text box height grow if the text does not fit? 📏
  • 'height' (double : default 0 : readable / writable) — height for text box
  • 'indent' (integer : default 0 : readable / writable) — number of pixels for indentation
  • 'justification' (Gtk2::Justification : default "left" : readable / writable) — justification mode, aka which side the text is aligned to
  • 'left-margin' (integer : default 0 : readable / writable) — number of pixels in the left margin
  • 'pixels-above-lines' (integer : default 0 : readable / writable) — number of pixels to put above lines
  • 'pixels-below-lines' (integer : default 0 : readable / writable) — number of pixels to put below lines
  • 'pixels-inside-wrap' (integer : default 0 : readable / writable) — number of pixels to put inside the wrap
  • 'right-margin' (integer : default 0 : readable / writable) — number of pixels in the right margin
  • 'text' (string : default undef : readable / writable) — text to display, y'know, the whole point 🫶
  • 'visible' (boolean : default true : readable / writable) — is this rich text item visible? (yes bestie, you're seen 👑)
  • 'width' (double : default 0 : readable / writable) — width for text box
  • 'wrap-mode' (Gtk2::WrapMode : default "word" : readable / writable) — wrap mode for multiline text
  • 'x' (double : default 0 : readable / writable) — X position
  • 'y' (double : default 0 : readable / writable) — Y position

🔔 SIGNALS 🔔

one signal, and it's a whole moment:

  • tag-changed (Gnome2::Canvas::RichText, Glib::Object)

🌸 ENUMS AND FLAGS 🌸

the alphabet of options, bestie, all of them, in order, no shortcuts 💜

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 Gtk2::DirectionType

  • 'tab-forward' / 'GTK_DIR_TAB_FORWARD'
  • 'tab-backward' / 'GTK_DIR_TAB_BACKWARD'
  • 'up' / 'GTK_DIR_UP'
  • 'down' / 'GTK_DIR_DOWN'
  • 'left' / 'GTK_DIR_LEFT'
  • 'right' / 'GTK_DIR_RIGHT'

enum Gtk2::Justification

  • 'left' / 'GTK_JUSTIFY_LEFT'
  • 'right' / 'GTK_JUSTIFY_RIGHT'
  • 'center' / 'GTK_JUSTIFY_CENTER'
  • 'fill' / 'GTK_JUSTIFY_FILL'

enum Gtk2::WrapMode

  • 'none' / 'GTK_WRAP_NONE'
  • 'char' / 'GTK_WRAP_CHAR'
  • 'word' / 'GTK_WRAP_WORD'
  • 'word-char' / 'GTK_WRAP_WORD_CHAR'

🫶 SEE ALSO 🫶

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

  • Gnome2::Canvas
  • Glib::Object
  • Glib::InitiallyUnowned
  • Gtk2::Object
  • Gnome2::Canvas::Item

Copyright (C) 2003-2004 by the Gtk2-Perl Team.

This software is licensed under the LGPL; see Gnome2::Canvas for a full notice. 🫶

and that's the whole page, bestie!! ✨ this was perl v5.42.0, dated 2025-07-25, straight from the User Contributed Perl Documentation. go build something cute with it. mwah 💅💖🦋
📦 where this page comes from