Gtk2::Tooltip(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 Gtk2::Tooltip — bestie edition 💖

okay so this is the perl wrapper for GtkTooltip, from the Gtk2 docs (User Contributed Perl Documentation, no cap). if you've ever hovered over a button and a lil text bubble popped up to explain things? yeah, that's this. the tooltip is the main character here and we're just hyping it up 🎀

🌸 HIERARCHY 🌸

it's giving family tree, and this one is a direct line:

Glib::Object
+----Gtk2::Tooltip

so Gtk2::Tooltip is a Glib::Object and nothing else. simple. elegant. iconic. 💅

✨ METHODS ✨

every one of these is called on a $tooltip object, bestie. here's the whole roster 🫶

  • $tooltip->set_custom ($custom_widget) — swap in your own custom widget as the tooltip body. it takes:
    • $custom_widget (a Gtk2::Widget, or undef if you want to be mysterious and give it nothing 🙈)
  • $tooltip->set_icon_from_icon_name ($icon_name, $size) — sets the tooltip's icon by icon name, which is very "i know a guy" of you. args:
    • $icon_name (string)
    • $size (a Gtk2::IconSize)
⭐ Since: gtk+ 2.14 — so like, vintage. older gtk+ won't know her.
  • $tooltip->set_icon_from_stock ($stock_id, $size) — the stock-id version of the above. args:
    • $stock_id (string or undef)
    • $size (a Gtk2::IconSize)
  • $tooltip->set_icon ($pixbuf) — straight-up hands the tooltip a pixbuf as its icon. args:
    • $pixbuf (a Gtk2::Gdk::Pixbuf or undef)
  • $tooltip->set_markup ($markup) — sets the tooltip text as Pango markup, so you can get fancy with it ✨ args:
    • $markup (string or undef)
  • $tooltip->set_text ($text) — the plain-text one. just words. no markup. lowkey the chillest option. args:
    • $text (string or undef)
  • $tooltip->set_tip_area ($rect) — tells the tooltip which region it's actually pointing at. args:
    • $rect (a Gtk2::Gdk::Rectangle or undef)
  • Gtk2::Tooltip::trigger_tooltip_query ($display) — note that this one is a class method, not an instance one, so you call it as Gtk2::Tooltip::trigger_tooltip_query, not on a $tooltip. it pokes the display to re-ask about tooltips. args:
    • $display (a Gtk2::Gdk::Display)

🦋 ENUMS AND FLAGS 🦋

enum Gtk2::IconSize

these are your size options, and each one has a short name and a long name — same vibe, different fonts 💜

  • 'invalid' / GTK_ICON_SIZE_INVALID
  • 'menu' / GTK_ICON_SIZE_MENU
  • 'small-toolbar' / GTK_ICON_SIZE_SMALL_TOOLBAR
  • 'large-toolbar' / GTK_ICON_SIZE_LARGE_TOOLBAR
  • 'button' / GTK_ICON_SIZE_BUTTON
  • 'dnd' / GTK_ICON_SIZE_DND
  • 'dialog' / GTK_ICON_SIZE_DIALOG

👀 SEE ALSO 👀

go read these too, bestie, they're the whole ecosystem:

  • Gtk2
  • Glib::Object

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 whole page, no crumbs left 💅 this doc came from perl v5.42.0 and was dated 2025-07-25 — mwah, stan the gtk2-perl team, they ate and left zero notes 🫶✨

📦 where this page comes from