Gtk2::RecentFilter(3)

📦
version 1.24993 · 2 versions
, in fedora 43

💖 Gtk2::RecentFilter — NAME 💖

okay bestie, so this is Gtk2::RecentFilter — it's the wrapper for GtkRecentFilter 🎀 like, it's the lil bouncer at the door of your recent-files list deciding who gets in and who gets left on read 💅

(this page lives in the User Contributed Perl Documentation section, so you know it's the real deal ✨)

🌸 HIERARCHY 🌸

the family tree, and yes she has main character energy:

Glib::Object
+----Glib::InitiallyUnowned
     +----Gtk2::Object
          +----Gtk2::RecentFilter

so she's a Glib::Object, she's a Glib::InitiallyUnowned, she's a Gtk2::Object, and then she's her 🦋 iconic lineage ngl

✨ METHODS ✨

🫶 constructors and adding stuff

  • recentfilter = Gtk2::RecentFilter->new — boom, brand new filter, fresh out the box 🌈
  • $filter->add_age ($days) — adds an age rule to the filter, so only recent things within a certain age get through ⏳
    • $days (integer) — how many days back we're talking
  • $filter->add_application ($application) — only let stuff from a specific app pass 🍓
    • $application (string) — the application name
  • $filter->add_custom ($needed, $func, $data=undef) — you get to write your own lil rule, custom vibes only 💅
    • $needed (Gtk2::RecentFilterFlags) — which flags your custom check needs
    • $func (scalar) — your callback
    • $data (scalar) — optional extra data you wanna pass along, defaults to undef
  • $filter->add_group ($group) — filters by group 🎀
    • $group (string)
  • $filter->add_mime_type ($mime_type) — only let a certain MIME type through, like text/plain or whatever 🦋
    • $mime_type (string)
  • $filter->add_pattern ($pattern) — adds a glob pattern rule, like *.png bestie 🌸
    • $pattern (string)
  • $filter->add_pixbuf_formats — adds a rule so anything GdkPixbuf can actually load gets through, no args needed, she just knows 🔥

💜 using it and naming it

  • boolean = $filter->filter ($filter_info) — runs the filter against some info and tells you yes or no, true or false, in or out 👑
    • $filter_info (scalar)
  • string = $filter->get_name — grabs the filter's name 🏷️
  • $filter->set_name ($name) — sets the filter's name ✨
    • $name (string)
  • recentfilterflags = $filter->get_needed — tells you which flags this filter actually needs 💫

🌈 ENUMS AND FLAGS 🌈

flags Gtk2::RecentFilterFlags

all the flag options, every single one, no skipping:

  • 'uri' / GTK_RECENT_FILTER_URI — 💖
  • 'display-name' / GTK_RECENT_FILTER_DISPLAY_NAME — 🎀
  • 'mime-type' / GTK_RECENT_FILTER_MIME_TYPE — 🦋
  • 'application' / GTK_RECENT_FILTER_APPLICATION — 🍓
  • 'group' / GTK_RECENT_FILTER_GROUP — 🌸
  • 'age' / GTK_RECENT_FILTER_AGE — ⏳

👀 SEE ALSO 👀

go read these too, they're all in the friend group:

  • Gtk2
  • Glib::Object
  • Glib::InitiallyUnowned
  • Gtk2::Object

Copyright (C) 2003-2011 by the gtk2-perl team. 🫶

This software is licensed under the LGPL. See Gtk2 for a full notice. 📜

ok that's the whole page bestie, you ate that fr fr 💅✨

this was perl v5.42.0, dated 2025-07-25, from Gtk2::RecentFilter(3) — mwah, go slay some recent files 🎀🦋💖

📦 where this page comes from