GtkRecentManager {RGtk2}R Documentation

GtkRecentManager

Description

Managing Recently Used Files

Methods and Functions

gtkRecentManagerNew()
gtkRecentManagerGetDefault()
gtkRecentManagerGetForScreen(screen)
gtkRecentManagerGetForScreen(screen)
gtkRecentManagerSetScreen(object, screen)
gtkRecentManagerSetScreen(object, screen)
gtkRecentManagerAddItem(object, uri)
gtkRecentManagerAddFull(object, uri, recent.data)
gtkRecentManagerRemoveItem(object, uri, .errwarn = TRUE)
gtkRecentManagerLookupItem(object, uri, .errwarn = TRUE)
gtkRecentManagerHasItem(object, uri)
gtkRecentManagerMoveItem(object, uri, new.uri, .errwarn = TRUE)
gtkRecentManagerGetLimit(object)
gtkRecentManagerSetLimit(object, limit)
gtkRecentManagerGetItems(object)
gtkRecentManagerPurgeItems(object, .errwarn = TRUE)
gtkRecentInfoRef(object)
gtkRecentInfoUnref(object)
gtkRecentInfoGetUri(object)
gtkRecentInfoGetDisplayName(object)
gtkRecentInfoGetDescription(object)
gtkRecentInfoGetMimeType(object)
gtkRecentInfoGetAdded(object)
gtkRecentInfoGetModified(object)
gtkRecentInfoGetVisited(object)
gtkRecentInfoGetPrivateHint(object)
gtkRecentInfoGetApplicationInfo(object, app.name)
gtkRecentInfoGetApplications(object, length)
gtkRecentInfoLastApplication(object)
gtkRecentInfoGetGroups(object)
gtkRecentInfoHasGroup(object, group.name)
gtkRecentInfoHasApplication(object, app.name)
gtkRecentInfoGetIcon(object, size)
gtkRecentInfoGetShortName(object)
gtkRecentInfoGetUriDisplay(object)
gtkRecentInfoGetAge(object)
gtkRecentInfoIsLocal(object)
gtkRecentInfoExists(object)
gtkRecentInfoMatch(object, info.b)
gtkRecentManager()

Hierarchy

GObject
   +----GtkRecentManager

Detailed Description

GtkRecentManager provides a facility for adding, removing and looking up recently used files. Each recently used file is identified by its URI, and has meta-data associated to it, like the names and command lines of the applications that have registered it, the number of time each application has registered the same file, the mime type of the file and whether the file should be displayed only by the applications that have registered it.

The GtkRecentManager acts like a database of all the recently used files. You can create new GtkRecentManager objects, but it is more efficient to use the standard recent manager for the GdkScreen so that informations about the recently used files is shared with other people using them. In case the default screen is being used, adding a new recently used file is as simple as:

manager <- gtkRecentManagerGetDefault()
manager$addItem(file_uri)

manager <- gtkRecentManagerGetDefault()
lookup <- manager$lookupItem(file_uri)
if (lookup$error)
  warning("Could not find the file:", lookup$error$message)
else use_info_object(lookup$retval)
Recently used files are supported since GTK+ 2.10.

Structures

Convenient Construction

gtkRecentManager is the equivalent of gtkRecentManagerNew.

Enums and Flags

GtkRecentManagerError

Error codes for GtkRecentManager operations

not-found

the URI specified does not exists in the recently used resources list.

invalid-uri

the URI specified is not valid.

invalid-encoding

the supplied string is not UTF-8 encoded.

not-registered

no application has registered the specified item.

read

failure while reading the recently used resources file.

write

failure while writing the recently used resources file.

unknown

unspecified error.

Signals

changed(recent.manager, user.data)

Emitted when the current recently used resources manager changes its contents. Since 2.10

recent.manager

the recent manager

user.data

user data set when the signal handler was connected.

Properties

Author(s)

Derived by RGtkGen from GTK+ documentation

References

http://library.gnome.org/devel//gtk/GtkRecentManager.html


[Package RGtk2 version 2.20.21 Index]