class Gtk::RecentManager

• Gtk::RecentManager
• GObject::Object
• Reference
• Object

Overview

Gtk::RecentManager manages and looks up recently used files.

Each recently used file is identified by its URI, and has meta-data associated to it, like the names and command lines of the applications that have registered it, the number of time each application has registered the same file, the mime type of the file and whether the file should be displayed only by the applications that have registered it.

The recently used files list is per user.

Gtk::RecentManager acts like a database of all the recently used files. You can create new Gtk::RecentManager objects, but it is more efficient to use the default manager created by GTK.

Adding a new recently used file is as simple as:

WARNING ⚠️ The following code is in c ⚠️

Gtk::RecentManager *manager;

manager = gtk_recent_manager_get_default ();
gtk_recent_manager_add_item (manager, file_uri);

The Gtk::RecentManager will try to gather all the needed information from the file itself through GIO.

Looking up the meta-data associated with a recently used file given its URI requires calling Gtk::RecentManager#lookup_item:

WARNING ⚠️ The following code is in c ⚠️

Gtk::RecentManager *manager;
Gtk::RecentInfo *info;
GError *error = NULL;

manager = gtk_recent_manager_get_default ();
info = gtk_recent_manager_lookup_item (manager, file_uri, &error);
if (error)
  {
    g_warning ("Could not find the file: %s", error->message);
    g_error_free (error);
  }
else
 {
   // Use the info object
   gtk_recent_info_unref (info);
 }

In order to retrieve the list of recently used files, you can use Gtk::RecentManager#items, which returns a list of Gtk::RecentInfo.

Note that the maximum age of the recently used files list is controllable through the [property@Gtk.Settings:gtk-recent-files-max-age] property.

Defined in:

Constructors

• .new : self

  Creates a new recent manager object.

• .new(*, filename : String | Nil = nil, size : Int32 | Nil = nil)

Class Method Summary

• .default : Gtk::RecentManager

  Gets a unique instance of Gtk::RecentManager that you can share in your application without caring about memory management.

• .g_type : UInt64

  Returns the type id (GType) registered in GLib type system.

Instance Method Summary

• #==(other : self)

  Returns true if this reference is the same as other.

• #add_full(uri : String, recent_data : Gtk::RecentData) : Bool

  Adds a new resource, pointed by uri, into the recently used resources list, using the metadata specified inside the Gtk::RecentData passed in recent_data.

• #add_item(uri : String) : Bool

  Adds a new resource, pointed by uri, into the recently used resources list.

• #changed_signal
• #filename : String
• #filename=(value : String) : String
• #filename=(value : Nil) : Nil

  Set #filename property to nil.

• #filename? : String | Nil

  Same as #filename, but can return nil.

• #has_item(uri : String) : Bool

  Checks whether there is a recently used resource registered with uri inside the recent manager.

• #hash(hasher)

  See Object#hash(hasher)

• #items : GLib::List

  Gets the list of recently used resources.

• #lookup_item(uri : String) : Gtk::RecentInfo | Nil

  Searches for a URI inside the recently used resources list, and returns a Gtk::RecentInfo containing information about the resource like its MIME type, or its display name.

• #move_item(uri : String, new_uri : String | Nil) : Bool

  Changes the location of a recently used resource from uri to new_uri.

• #purge_items : Int32

  Purges every item from the recently used resources list.

• #remove_item(uri : String) : Bool

  Removes a resource pointed by uri from the recently used resources list handled by a recent manager.

• #size : Int32

Constructor Detail

Class Method Detail

Instance Method Detail