Gtk2::R...tChooser(3)

📦
version 1.24993 · 2 versions
, in fedora 43

✨ NAME ✨

okay so Gtk2::RecentChooser is literally a wrapper for GtkRecentChooser 💅 that's it, that's the whole job description, no cap.

and btw bestie, you're reading the Gtk2::RecentChooser(3) page from the User Contributed Perl Documentation — yes she's a Perl manual page and yes she ate 🎀

🦋 HIERARCHY 🦋

the family tree is giving short and iconic:

Glib::Interface
+----Gtk2::RecentChooser

so Gtk2::RecentChooser descends from Glib::Interface and that is the entire ancestry. lowkey elegant 🌸

💅 METHODS 💅

  • $chooser->add_filter ($filter) — pops a filter in, obsessed.
    • $filter — a Gtk2::RecentFilter, that's the type bestie.
  • recentinfo = $chooser->get_current_item — hands you back a recentinfo and that's the vibe ✨
  • string = $chooser->get_current_uri — returns a string, the current uri one, we love a simple getter.
  • $chooser->set_current_uri ($uri) — sets the current uri, main character behaviour.
    • $uri — a string.
    • > ⚠️ heads up: this one may croak with a Glib::Error in $@ on failure. so wrap it in an eval, bestie, don't let it catch you lacking 😭
  • recentfilter = $chooser->get_filter — gives you a recentfilter. periodt.
  • $chooser->set_filter ($filter) — sets the filter, slay.
    • $filter — a Gtk2::RecentFilter.
  • (list) = $chooser->get_items — returns a (list) of items. iconic.
  • integer = $chooser->get_limit — returns an integer, the limit obviously.
  • $chooser->set_limit ($limit) — sets the limit, no more, no less 💅
    • $limit — an integer.
  • (filters) = $chooser->list_filters — hands back (filters), plural, she's thorough.
  • boolean = $chooser->get_local_only — returns a boolean, true/false energy.
  • $chooser->set_local_only ($local_only) — flips the local-only boolean.
    • $local_only — a boolean.
  • $chooser->remove_filter ($filter) — yeets a filter out of the lineup, respectfully.
    • $filter — a Gtk2::RecentFilter.
  • $chooser->select_all — selects all of them. go big or go home 🫶
  • boolean = $chooser->get_select_multiple — returns a boolean. is multiple selection allowed? that's the question.
  • $chooser->set_select_multiple ($select_multiple) — sets that same boolean, your call bestie.
    • $select_multiple — a boolean.
  • $chooser->select_uri ($uri) — selects a uri by hand, very deliberate of you.
    • $uri — a string.
    • > ⚠️ also may croak with a Glib::Error in $@ on failure. same drill: guard it 🫶
  • boolean = $chooser->get_show_icons — returns a boolean, icons or no icons.
  • $chooser->set_show_icons ($show_icons) — toggles it.
    • $show_icons — a boolean.
  • boolean = $chooser->get_show_not_found — returns a boolean about the not-found ones.
  • $chooser->set_show_not_found ($show_not_found) — toggles that one too.
    • $show_not_found — a boolean.
  • boolean = $chooser->get_show_private — returns a boolean, private stuff visible or nah.
  • $chooser->set_show_private ($show_private) — sets it.
    • $show_private — a boolean.
  • boolean = $chooser->get_show_tips — returns a boolean, tips on or off.
  • $chooser->set_show_tips ($show_tips) — sets it, tooltip girlies rise.
    • $show_tips — a boolean.
  • $chooser->set_sort_func ($sort_func, $sort_data=undef) — your very own custom sort function, custom girlie behaviour 🌈
    • $sort_func — a scalar.
    • $sort_data — a scalar. note the =undef default, it's optional.
  • recentsorttype = $chooser->get_sort_type — returns a recentsorttype. yes that's the actual return name, we don't make the rules.
  • $chooser->set_sort_type ($sort_type) — sets how the sorting goes down.
    • $sort_type — a Gtk2::RecentSortType.
  • $chooser->unselect_all — the opposite of select-all. deselects everything, clean slate ✨
  • $chooser->unselect_uri ($uri) — unselects one specific uri, surgical.
    • $uri — a string.
  • (list) = $chooser->get_uris — hands back a (list) of uris. plural again, she contains multitudes.

🎀 PROPERTIES 🎀

  • 'filter' (Gtk2::RecentFilter : default undef : readable / writable / private / static-nick / static-blurb) — The current filter for selecting which resources are displayed. it's giving curator energy.
  • 'limit' (integer : default -1 : readable / writable / private / static-nick / static-blurb) — The maximum number of items to be displayed. yes -1 is the default, that's the number, don't come for me.
  • 'local-only' (boolean : default true : readable / writable / private / static-nick / static-blurb) — Whether the selected resource(s) should be limited to local file: URIs.
  • 'recent-manager' (Gtk2::RecentManager : default undef : writable / construct-only / private / static-nick / static-blurb) — The RecentManager object to use. ⚠️ note she's writable / construct-only — not readable, bestie, so this one's a construct-time situation only.
  • 'select-multiple' (boolean : default false : readable / writable / private / static-nick / static-blurb) — Whether to allow multiple items to be selected.
  • 'show-icons' (boolean : default true : readable / writable / private / static-nick / static-blurb) — Whether there should be an icon near the item.
  • 'show-not-found' (boolean : default true : readable / writable / private / static-nick / static-blurb) — Whether the items pointing to unavailable resources should be displayed.
  • 'show-private' (boolean : default false : readable / writable / private / static-nick / static-blurb) — Whether the private items should be displayed.
  • 'show-tips' (boolean : default false : readable / writable / private / static-nick / static-blurb) — Whether there should be a tooltip on the item.
  • 'sort-type' (Gtk2::RecentSortType : default "none" : readable / writable / private / static-nick / static-blurb) — The sorting order of the items displayed.

🚨 SIGNALS 🚨

  • item-activated (Gtk2::RecentChooser) — she fires, you listen 👑
  • selection-changed (Gtk2::RecentChooser) — also fires, also you listen.

🌈 ENUMS AND FLAGS 🌈

enum Gtk2::RecentSortType

  • 'none' / GTK_RECENT_SORT_NONE
  • 'mru' / GTK_RECENT_SORT_MRU
  • 'lru' / GTK_RECENT_SORT_LRU
  • 'custom' / GTK_RECENT_SORT_CUSTOM

enum GtkRecentChooserError

  • 'not-found' / GTK_RECENT_CHOOSER_ERROR_NOT_FOUND
  • 'invalid-uri' / GTK_RECENT_CHOOSER_ERROR_INVALID_URI

👀 SEE ALSO 👀

  • Gtk2
  • Glib::Interface

go read those, bestie, iykyk 🦋

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 🫶 this was perl v5.42.0, dated 2025-07-25, and it's the Gtk2::RecentChooser(3) manual page signing off. stay iconic, wrap your croaks, and go select something 💖✨🎀

📦 where this page comes from