Back to Seed Clases

Gtk

Classes

Interfaces

Structs

Unions

Enums

GObject.Object
parent-child marker Gtk.RecentManager

Class Gtk.RecentManager

Import line:	Gtk = imports.gi.Gtk;
GIR File:	Gtk-3.0.gir
C documentation:	GtkRecentManager
Class :	RecentManager
Extends:	GObject.Object

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_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
structures.
A GtkRecentManager is the model used to populate the contents of
one, or more GtkRecentChooser implementations.
The maximum age of the recently used files list is
controllable through the GtkSettings:gtk-recent-files-max-age
property.
Recently used files are supported since GTK+ 2.10.

Properties
Properties		Defined By
	filename : String The full path to the file to be used to store and read the recently used resources list The full path to the file to be used to store and read the recently used resources list	Gtk.RecentManager
	parent_instance : GObject.Object read only	Gtk.RecentManager
	priv : Gtk.RecentManagerPrivate read only	Gtk.RecentManager
	size : gint32 read only The size of the recently used resources list. The size of the recently used resources list.	Gtk.RecentManager

Methods / Constructors
Method / Constructor		Defined By
	new Gtk.RecentManager (Object *properties) Create a new Gtk.RecentManager Create a new Gtk.RecentManager Parameters: Object properties*
	Gtk.RecentManager.get_default () : Gtk.RecentManager Gets a unique instance of GtkRecentManager, that you can share in your application without caring about memory management. Gets a unique instance of GtkRecentManager, that you can share in your application without caring about memory management. Returns: Gtk.RecentManager A unique GtkRecentManager. Do not ref or unref it.	Gtk.RecentManager
	add_full (String *uri, RecentData recent_data) : gboolean Adds a new resource, pointed by uri, into the recently used resources list, using the metadata specified inside the GtkRecentData* structure passed in recent_data. Adds a new resource, pointed by uri, into the recently used resources list, using the metadata specified inside the GtkRecentData structure passed in recent_data. The passed URI will be used to identify this resource inside the list. In order to register the new recently used resource, metadata about the resource must be passed as well as the URI; the metadata is stored in a GtkRecentData structure, which must contain the MIME type of the resource pointed by the URI; the name of the application that is registering the item, and a command line to be used when launching the item. Optionally, a GtkRecentData structure might contain a UTF-8 string to be used when viewing the item instead of the last component of the URI; a short description of the item; whether the item should be considered private - that is, should be displayed only by the applications that have registered it. recently used resources list, FALSE otherwise. Parameters: String uri Required (not null) a valid URI Gtk.RecentData recent_data Required (not null) metadata of the resource Returns: gboolean TRUE if the new item was successfully added to the	Gtk.RecentManager
	add_item (String *uri) : gboolean Adds a new resource, pointed by uri, into the recently used resources list. Adds a new resource, pointed by uri, into the recently used resources list. This function automatically retrieves some of the needed metadata and setting other metadata to common default values; it then feeds the data to gtk_recent_manager_add_full(). See gtk_recent_manager_add_full() if you want to explicitly define the metadata for the resource pointed by uri. to the recently used resources list Parameters: String uri* Required (not null) a valid URI Returns: gboolean TRUE if the new item was successfully added	Gtk.RecentManager
	get_items () : Array Gets the list of recently used resources. Gets the list of recently used resources. newly allocated GtkRecentInfo objects. Use gtk_recent_info_unref() on each item inside the list, and then free the list itself using g_list_free(). Returns: Array a list of	Gtk.RecentManager
	has_item (String *uri) : gboolean Checks whether there is a recently used resource registered with uri* inside the recent manager. Checks whether there is a recently used resource registered with uri inside the recent manager. Parameters: String uri Required (not null) a URI Returns: gboolean TRUE if the resource was found, FALSE otherwise.	Gtk.RecentManager
	lookup_item (String *uri) : Gtk.RecentInfo Searches for a URI inside the recently used resources list, and returns a structure containing informations about the resource like its MIME type, or its display name. Searches for a URI inside the recently used resources list, and returns a structure containing informations about the resource like its MIME type, or its display name. about the resource pointed by uri, or NULL* if the URI was not registered in the recently used resources list. Free with gtk_recent_info_unref(). Parameters: String uri Required (not null) a URI Returns: Gtk.RecentInfo a GtkRecentInfo structure containing information	Gtk.RecentManager
	move_item (String *uri, String new_uri) : gboolean Changes the location of a recently used resource from uri* to new_uri. Changes the location of a recently used resource from uri to new_uri. Please note that this function will not affect the resource pointed by the URIs, but only the URI used in the recently used resources list. Parameters: String uri Required (not null) the URI of a recently used resource String new_uri the new URI of the recently used resource, or NULL to remove the item pointed by uri in the list Returns: gboolean TRUE on success.	Gtk.RecentManager
	purge_items () : gint32 Purges every item from the recently used resources list. Purges every item from the recently used resources list. recently used resources list. Returns: gint32 the number of items that have been removed from the	Gtk.RecentManager
	remove_item (String *uri) : gboolean Removes a resource pointed by uri* from the recently used resources list handled by a recent manager. Removes a resource pointed by uri from the recently used resources list handled by a recent manager. removed by the recently used resources list, and FALSE otherwise. Parameters: String uri Required (not null) the URI of the item you wish to remove Returns: gboolean TRUE if the item pointed by uri has been successfully	Gtk.RecentManager

Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event		Defined By
	changed (RecentManager *self) : none Emitted when the current recently used resources manager changes its contents, either by calling gtk_recent_manager_add_item() or by another application. Emitted when the current recently used resources manager changes its contents, either by calling gtk_recent_manager_add_item() or by another application. Parameters: Gtk.RecentManager self* Returns: {none}	Gtk.RecentManager

Used by These Methods / Signals / Properties
Class / Namespace	Method / Signal / Properties
Gtk.RecentAction Method	new Gtk.RecentAction.for_manager (String *name, String label, String tooltip, String stock_id, RecentManager manager*) : Gtk.Action Create a new Gtk.RecentAction
Gtk.RecentChooser Property	recent_manager : Gtk.RecentManager The GtkRecentManager instance used by the GtkRecentChooser to display the list of recently used resources.
Gtk.RecentChooserMenu Method	new Gtk.RecentChooserMenu.for_manager (RecentManager *manager*) : Gtk.Widget Create a new Gtk.RecentChooserMenu
Gtk.RecentChooserWidget Method	new Gtk.RecentChooserWidget.for_manager (RecentManager *manager*) : Gtk.Widget Create a new Gtk.RecentChooserWidget