Class: Gtk::RecentManager
- Inherits:
-
Object
- Object
- Gtk::RecentManager
- Defined in:
- (unknown)
Overview
Gtk::RecentManagerClass contains only private data.
Instance Method Summary collapse
-
#add_full(uri, recent_data) ⇒ TrueClass
Adds a new resource, pointed by uri, into the recently used resources list, using the metadata specified inside the Gtk::RecentData-struct passed in recent_data.
-
#add_item(uri) ⇒ TrueClass
Adds a new resource, pointed by uri, into the recently used resources list.
-
#filename ⇒ String
The full path to the file to be used to store and read the recently used resources list.
-
#filename=(filename) ⇒ String
The full path to the file to be used to store and read the recently used resources list.
-
#has_item(uri) ⇒ TrueClass
Checks whether there is a recently used resource registered with uri inside the recent manager.
-
#items ⇒ GLib::List
Gets the list of recently used resources.
-
#lookup_item(uri) ⇒ Gtk::RecentInfo
Searches for a URI inside the recently used resources list, and returns a Gtk::RecentInfo-struct containing informations about the resource like its MIME type, or its display name.
-
#move_item(uri, new_uri) ⇒ TrueClass
Changes the location of a recently used resource from uri to new_uri.
-
#new ⇒ Gtk::RecentManager
Creates a new recent manager object.
-
#purge_items ⇒ Integer
Purges every item from the recently used resources list.
-
#remove_item(uri) ⇒ TrueClass
Removes a resource pointed by uri from the recently used resources list handled by a recent manager.
-
#size ⇒ Integer
The size of the recently used resources list.
-
#size=(size) ⇒ Integer
The size of the recently used resources list.
Instance Method Details
#add_full(uri, recent_data) ⇒ TrueClass
Adds a new resource, pointed by uri, into the recently used resources list, using the metadata specified inside the Gtk::RecentData-struct 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 Gtk::RecentData-struct, 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 Gtk::RecentData-struct 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.
#add_item(uri) ⇒ TrueClass
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.
#filename ⇒ String
The full path to the file to be used to store and read the recently used resources list
#filename=(filename) ⇒ String
The full path to the file to be used to store and read the recently used resources list
#has_item(uri) ⇒ TrueClass
Checks whether there is a recently used resource registered with uri inside the recent manager.
#items ⇒ GLib::List
Gets the list of recently used resources.
#lookup_item(uri) ⇒ Gtk::RecentInfo
Searches for a URI inside the recently used resources list, and returns a Gtk::RecentInfo-struct containing informations about the resource like its MIME type, or its display name.
#move_item(uri, new_uri) ⇒ TrueClass
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.
#new ⇒ 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 expensive: be sure to create them only when needed. You should use gtk_recent_manager_get_default() instead.
#purge_items ⇒ Integer
Purges every item from the recently used resources list.
#remove_item(uri) ⇒ TrueClass
Removes a resource pointed by uri from the recently used resources list handled by a recent manager.
#size ⇒ Integer
The size of the recently used resources list.
#size=(size) ⇒ Integer
The size of the recently used resources list.