Gtk2::RecentManager(3) User Contributed Perl Documentation Gtk2::RecentManager(3)

Gtk2::RecentManager - wrapper for GtkRecentManager

Glib::Object
+----Gtk2::RecentManager

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:

The name to be used when displaying the document inside the recently used documents list.
A short description of the document.
The MIME type of the document. [Mandatory]
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).
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.
An array reference, containing the group names the document belongs to.
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)

integer = $manager->get_limit

$manager->set_limit ($limit)

$limit (integer)

$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

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)

'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 / deprecated)
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

  • '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'

Gtk2, Glib::Object

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL. See Gtk2 for a full notice.

2022-05-29 perl v5.36.0