Gtk2::RecentManager3pm
Wrapper for gtkrecentmanager
Hierarchy
Glib::Object+----Gtk2::RecentManager
Methods
recentmanager = Gtk2::RecentManager->new
boolean = $manager->add_full ($uri, $data)
•
|
|
|---|---|
•
|
|
Add $uri to the list of recently used documents. Instead of letting the Gtk2::RecentManager object guess the meta-data, use $data to supply it. $data is a hash reference with these keys:
- display_name
-
The name to be used when displaying the document inside the recently used documents list.
- description
-
A short description of the document.
- mime_type
-
The MIME type of the document. [Mandatory]
- app_name
-
The name of the application that is registering the document. You might use the same name you used in
"Glib::set_application_name"(see Glib::Utils).
- app_exec
-
The command line needed to launch the application with the document. You can use the variable
"%u", which will be expanded to the document's URI, or the variable"%f"which will be expanded to the document's canonical full path.
- groups
-
An array reference, containing the group names the document belongs to.
- is_private
-
Whether the document should be visible only to the applications and groups that have registered it.
boolean = $manager->add_item ($uri)
- •
-
$uri(string)
Add $uri to the list of recently used documents. The Gtk2::RecentManager object will try to guess the meta-data of the document from its URI, but if you know it you should use "add_full" above.
recentmanager = Gtk2::RecentManager->get_default
recentmanager = Gtk2::RecentManager->get_for_screen ($screen)
- •
-
$screen(Gtk2::Gdk::Screen)
boolean = $manager->has_item ($uri)
- •
-
$uri(string)
(items) = $manager->get_items
integer = $manager->get_limit
$manager->set_limit ($limit)
- •
-
$limit(integer)
recentinfo = $manager->lookup_item ($uri)
- •
-
$uri(string)
May croak with a Glib::Error in $@ on failure.
$manager->move_item ($old_uri, $new_uri)
•
|
|
|---|---|
•
|
|
May croak with a Glib::Error in $@ on failure.
integer = $manager->purge_items
May croak with a Glib::Error in $@ on failure.
$manager->remove_item ($uri)
- •
-
$uri(string)
May croak with a Glib::Error in $@ on failure.
$manager->set_screen ($screen)
- •
-
$screen(Gtk2::Gdk::Screen)
Properties
'filename' (string : default undef : readable / writable / construct-only)
|
The full path to the file to be used to store and read the list |
|---|---|
'limit' (integer : default -1 : readable / writable)
|
The maximum number of items to be returned by gtk_recent_manager_get_items() |
'size' (integer : default 0 : readable)
|
The size of the recently used resources list |
Signals
changed(Gtk2::RecentManager)
Enums and flags
enum GtkRecentManagerError
•
|
'not-found' / 'GTK_RECENT_MANAGER_ERROR_NOT_FOUND' |
|---|---|
•
|
'invalid-uri' / 'GTK_RECENT_MANAGER_ERROR_INVALID_URI' |
•
|
'invalid-encoding' / 'GTK_RECENT_MANAGER_ERROR_INVALID_ENCODING' |
•
|
'not-registered' / 'GTK_RECENT_MANAGER_ERROR_NOT_REGISTERED' |
•
|
'read' / 'GTK_RECENT_MANAGER_ERROR_READ' |
•
|
'write' / 'GTK_RECENT_MANAGER_ERROR_WRITE' |
•
|
'unknown' / 'GTK_RECENT_MANAGER_ERROR_UNKNOWN' |
Releases
5 releases since Debian 5.0 (Lenny); the text changed 4 times.