RecentInfo

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: While looking up a recently used file is as simple as: Recently used files are supported since GTK+ 2.10.

Constructors

this
this(GtkRecentInfo* gtkRecentInfo)

Sets our main struct and passes it to the parent class

Members

Functions

doref
RecentInfo doref()

Increases the reference count of recent_info by one. Since 2.10

exists
int exists()

Checks whether the resource pointed by info still exists. At the moment this check is done only on resources pointing to local files. Since 2.10

getAdded
uint getAdded()

Gets the timestamp (seconds from system's Epoch) when the resource was added to the recently used resources list. Since 2.10

getAge
int getAge()

Gets the number of days elapsed since the last update of the resource pointed by info. Since 2.10

getApplicationInfo
int getApplicationInfo(string appName, string appExec, uint count, uint time)

Gets the data regarding the application that has registered the resource pointed by info. If the command line contains any escape characters defined inside the storage specification, they will be expanded. Since 2.10

getApplications
string[] getApplications()

Retrieves the list of applications that have registered this resource. Since 2.10

getDescription
string getDescription()

Gets the (short) description of the resource. Since 2.10

getDisplayName
string getDisplayName()

Gets the name of the resource. If none has been defined, the basename of the resource is obtained. Since 2.10

getGroups
string[] getGroups()

Returns all groups registered for the recently used item info. The array of returned group names will be NULL terminated, so length might optionally be NULL. Since 2.10

getIcon
Pixbuf getIcon(int size)

Retrieves the icon of size size associated to the resource MIME type. Since 2.10

getMimeType
string getMimeType()

Gets the MIME type of the resource. Since 2.10

getModified
uint getModified()

Gets the timestamp (seconds from system's Epoch) when the resource was last modified. Since 2.10

getPrivateHint
int getPrivateHint()

Gets the value of the "private" flag. Resources in the recently used list that have this flag set to TRUE should only be displayed by the applications that have registered them. Since 2.10

getRecentInfoStruct
GtkRecentInfo* getRecentInfoStruct()
Undocumented in source. Be warned that the author may not have intended to support it.
getShortName
string getShortName()

Computes a valid UTF-8 string that can be used as the name of the item in a menu or list. For example, calling this function on an item that refers to "file:///foo/bar.txt" will yield "bar.txt". Since 2.10

getStruct
void* getStruct()

the main Gtk struct as a void*

getUri
string getUri()

Gets the URI of the resource. Since 2.10

getUriDisplay
string getUriDisplay()

Gets a displayable version of the resource's URI. If the resource is local, it returns a local path; if the resource is not local, it returns the UTF-8 encoded content of gtk_recent_info_get_uri(). Since 2.10

getVisited
uint getVisited()

Gets the timestamp (seconds from system's Epoch) when the resource was last visited. Since 2.10

hasApplication
int hasApplication(string appName)

Checks whether an application registered this resource using app_name. Since 2.10

hasGroup
int hasGroup(string groupName)

Checks whether group_name appears inside the groups registered for the recently used item info. Since 2.10

isLocal
int isLocal()

Checks whether the resource is local or not by looking at the scheme of its URI. Since 2.10

lastApplication
string lastApplication()

Gets the name of the last application that have registered the recently used resource represented by info. Since 2.10

match
int match(RecentInfo infoB)

Checks whether two GtkRecentInfo structures point to the same resource. Since 2.10

unref
void unref()

Decreases the reference count of info by one. If the reference count reaches zero, info is deallocated, and the memory freed. Since 2.10

Variables

gtkRecentInfo
GtkRecentInfo* gtkRecentInfo;

the main Gtk struct

Meta