Gtk.RecentManager – gtk4 – Vala Binding Reference

Description:

[ CCode ( type_id = "gtk_recent_manager_get_type ()" ) ]
public class RecentManager : Object

`GtkRecentManager` 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.

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

Adding a new recently used file is as simple as:

```c GtkRecentManager *manager;

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

The `GtkRecentManager` 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 [[email protected]_item]:

```c GtkRecentManager *manager; GtkRecentInfo *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 [[email protected]_items], which returns a list of [ [email protected]].

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

Namespace: Gtk

Package: gtk4

Content:

Properties:

public string filename { owned get; construct; }

The full path to the file to be used to store and read the recently used resources list

public int size { get; }

The size of the recently used resources list.

Static methods:

public static unowned RecentManager get_default ()

Gets a unique instance of `GtkRecentManager` that you can share in your application without caring about memory management.

Creation methods:

public RecentManager ()

Creates a new recent manager object.

Methods:

public bool add_full (string uri, RecentData recent_data)

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

public bool add_item (string uri)

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

public List<RecentInfo> get_items ()

Gets the list of recently used resources.

public bool has_item (string uri)

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

public RecentInfo? lookup_item (string uri) throws Error

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

public bool move_item (string uri, string? new_uri) throws Error

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

public int purge_items () throws Error

Purges every item from the recently used resources list.

public bool remove_item (string uri) throws Error

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

Signals:

public virtual signal void changed ()

Emitted when the current recently used resources manager changes its contents.

Inherited Members:

All known members inherited from class GLib.Object

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref

RecentManager

Object Hierarchy: