Gtk2::RecentManager(3)

NAME
Gtk2::RecentManager

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

METHODS

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

SEE ALSO
Gtk2, Glib::Object

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

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