Gtk2::R...erDialog(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 NAME 💖

Gtk2::RecentChooserDialog — bestie, it's literally just a lil wrapper around GtkRecentChooserDialog. That's the whole vibe. 🎀

This page is chillin' in the Gtk2::R...erDialog(3) spot of the perl docs, and it's your one-stop shop for making a dialog that lets your user pick from their recently-used stuff. Obsessed. ✨

👑 HIERARCHY 👑

okay so this is the family tree and yes, it is giving generational trauma, but like, in a struct way:

  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::Bin
                           +----Gtk2::Window
                                +----Gtk2::Dialog
                                     +----Gtk2::RecentChooserDialog

every single one of those ancestors is real and they all had to sign off on this, periodt. 💅

🦋 INTERFACES 🦋

the personality traits it inherited (no cap):

  • Glib::Object::_Unregistered::AtkImplementorIface
  • Gtk2::Buildable
  • Gtk2::RecentChooser

🌸 METHODS 🌸

✨ widget = Gtk2::RecentChooserDialog->new ($title, $parent, ...) ✨

the classic constructor, main character energy fr fr. here's what you're feeding it:

  • $title (string) — the name of the dialog, like its little name tag 🏷️
  • $parent (Gtk2::Window or undef) — who its parent is, or literally undef if it's a free spirit 🕊️
  • ... (list) — a list of button-text => response-id pairs. yes, pairs. text then id, text then id, like a lil friendship bracelet. 🔥

✨ widget = Gtk2::RecentChooserDialog->new_for_manager ($title, $parent, $manager, ...) ✨

same energy, but this time you're bringing your own manager to the party:

  • $title (string) — dialog title, iconic as always 💅
  • $parent (Gtk2::Window or undef) — the parent window, or undef for the orphan arc 😭
  • ... (list) — list of button-text => response-id pairs, so your buttons know what to do when clicked 🎀
  • $manager (Gtk2::RecentManager) — the actual manager, the one holding all the recents 🧚
heads up bestie: the args are listed in that exact order in the docs, so don't come for me about $manager being last on the list — that's just how it's written. 🫶

🌈 SEE ALSO 🌈

go read these next, they're all connected, iykyk:

  • Gtk2
  • Glib::Object
  • Glib::InitiallyUnowned
  • Gtk2::Object
  • Gtk2::Widget
  • Gtk2::Container
  • Gtk2::Bin
  • Gtk2::Window
  • Gtk2::Dialog

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, bestie — no cap, we ate. this was documented by perl v5.42.0 on 2025-07-25 under the Gtk2::R...erDialog(3) banner, and now you know everything it knows. slay, go build something cute. 💖✨🦋

📦 where this page comes from