recentmanager = Gtk2::RecentManager->new¶

boolean = $manager->add_full ($uri, $data)¶

• $uri (string)
• $data (scalar)

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)¶

• $old_uri (string)
• $new_uri (string or undef)

May croak with a Glib::Error in $@ on failure.

integer = $manager->purge_items¶

$manager->remove_item ($uri)¶

•

$uri (string)

May croak with a Glib::Error in $@ on failure.

$manager->set_screen ($screen)¶

•

$screen (Gtk2::Gdk::Screen)

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'