Gtk2::RecentManager

NAME

Gtk2::RecentManager − wrapper for GtkRecentManager

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.