Class
Gtk.RecentManager
Description [src]
class Gtk.RecentManager : GObject.Object {
/* No available fields */
}GtkRecentManager provides a facility for adding, removing and
looking 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.
The 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:
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 gtk_recent_manager_lookup_item():
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
gtk_recent_manager_get_items(), which returns a list of GtkRecentInfo.
A GtkRecentManager is the model used to populate the contents of
one, or more GtkRecentChooser implementations.
Note that the maximum age of the recently used files list is
controllable through the GtkSettings:gtk-recent-files-max-age
property.
Constructors
gtk_recent_manager_new
Creates a new recent manager object. Recent manager objects are used to
handle the list of recently used resources. A GtkRecentManager object
monitors the recently used resources list, and emits the “changed” signal
each time something inside the list changes.
Instance methods
gtk_recent_manager_add_full
Adds a new resource, pointed by uri, into the recently used
resources list, using the metadata specified inside the
GtkRecentData passed in recent_data.
gtk_recent_manager_add_item
Adds a new resource, pointed by uri, into the recently used
resources list.
gtk_recent_manager_get_items
Gets the list of recently used resources.
gtk_recent_manager_has_item
Checks whether there is a recently used resource registered
with uri inside the recent manager.
gtk_recent_manager_lookup_item
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.
gtk_recent_manager_move_item
Changes the location of a recently used resource from uri to new_uri.
gtk_recent_manager_purge_items
Purges every item from the recently used resources list.
gtk_recent_manager_remove_item
Removes a resource pointed by uri from the recently used resources
list handled by a recent manager.
Properties
Gtk.RecentManager:filename
The full path to the file to be used to store and read the recently used resources list
Gtk.RecentManager:size
The size of the recently used resources list.
Signals
Gtk.RecentManager::changed
Emitted when the current recently used resources manager changes
its contents, either by calling gtk_recent_manager_add_item() or
by another application.
Class structure
struct GtkRecentManagerClass {
void (* changed) (
GtkRecentManager* manager
);
void (* _gtk_recent1) (
void
);
void (* _gtk_recent2) (
void
);
void (* _gtk_recent3) (
void
);
void (* _gtk_recent4) (
void
);
}Class members
changed |
|
| No description available. | |
_gtk_recent1 |
|
| No description available. | |
_gtk_recent2 |
|
| No description available. | |
_gtk_recent3 |
|
| No description available. | |
_gtk_recent4 |
|
| No description available. |