gtk.RecentManager

    gtk.RecentManager()

Creates a new recent manager object. Recent manager objects are used to handle the list of recently used resources. A gtk.RecentManager object monitors the recently used resources list, and emits the "changed" signal each time something inside the list changes.

gtk.RecentManager objects are expansive: be sure to create them only when needed. You should use the gtk.recent_manager_get_for_screen() or the gtk.recent_manager_get_default() functions instead.

gtk.RecentManager.set_screen

    def set_screen(screen)

Sets the screen for a recent manager; the screen is used to track the user's currently configured recently used documents storage.

gtk.RecentManager.add_item

    def add_item(uri)

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

This method automatically retrieves some of the needed metadata and sets other metadata to common default values.

See the gtk.RecentManager.add_full() method if you want to explicitly define the metadata for the resource pointed by uri.

gtk.RecentManager.add_full

    def add_full(uri, recent_data)

Adds a new resource, pointed by uri, into the recently used resources list, using the metadata specified inside the dict 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 dict, which must contain the MIME type of the resource pointed by the URI ("mime_type"), the name of the application that is registering the item ("app_name"), and a command line to be used when launching the item ("app_exec").

Optionally, the recent_data dict might contain a UTF-8 string to be used when viewing the item instead of the last component of the URI ("display_name"), a short description of the item ("description"), whether the item should be considered private - that is, should be displayed only by the applications that have registered it("is_private") or a list of the groups that the item belongs to ("groups").

gtk.RecentManager.remove_item

    def remove_item(uri)

Removes a resource pointed by uri from the recently used resources list handled by a recent manager. Raises the gobject.GError when an error occurs.

gtk.RecentManager.lookup_item

    def lookup_item(uri)

Searches for a URI inside the recently used resources list, and returns a gtk.RecentInfo object containing information about the resource like its MIME type, or its display name. Raises the gobject.GError when an error occurs.

gtk.RecentManager.has_item

    def has_item(uri)

Checks whether there is a recently used resource registered with uri.

gtk.RecentManager.move_item

    def move_item(uri, 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. Raises the gobject.GError when an error occurs.

gtk.RecentManager.set_limit

    def set_limit(limit)

Sets the maximum number of item that the gtk.RecentManager.get_items() function should return. If limit is set to -1, then return all the items.

gtk.RecentManager.get_limit

    def get_limit()

Returns the maximum number of items that the gtk.RecentManager.get_items() method should return.

gtk.RecentManager.get_items

    def get_items()

Returns the list of recently used resources as gtk.RecentInfo objects.

gtk.RecentManager.purge_items

    def purge_items()

Purges every item from the recently used resources list. Raises the gobject.GError when an error occurs.

gtk.recent_manager_get_default

    def gtk.recent_manager_get_default()

Gets the recent manager for the default screen. See the gtk.recent_manager_get_for_screen() function.

gtk.recent_manager_get_for_screen

    def gtk.recent_manager_get_for_screen(screen)

Gets the recent manager object associated with screen; if this function has not previously been called for the given screen, a new recent manager object will be created and associated with the screen. Recent manager objects are fairly expensive to create, so using this function is usually a better choice than calling the gtk.RecentManager() constructor and setting the screen yourself; by using this function a single recent manager object will be shared between users.

The "changed" gtk.RecentManager Signal

    def callback(recent_manager, user_param1, ...)

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