Gtk-3.0 ▶ Gtk ▶ RecentInfoAbstractSince 2.10

constructor

• new RecentInfo(): Gtk.RecentInfo

  Returns Gtk.RecentInfo

Static$gtype

create_app_info

• create_app_info(app_name?: string): Gio.AppInfo

  Creates a Gio.AppInfo for the specified Gtk.RecentInfo

  Parameters

  • Optionalapp_name: string

    the name of the application that should be mapped to a Gio.AppInfo; if null is used then the default application for the MIME type is used

  Returns Gio.AppInfo

  the newly created Gio.AppInfo, or null. In case of error, error will be set either with a GTK_RECENT_MANAGER_ERROR or a G_IO_ERROR

exists

• exists(): boolean

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

  Returns boolean

  true if the resource exists

get_added

• get_added(): number

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

  Returns number

  the number of seconds elapsed from system’s Epoch when the resource was added to the list, or -1 on failure.

get_age

• get_age(): number

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

  Returns number

  a positive integer containing the number of days elapsed since the time this resource was last modified

get_application_info

• get_application_info(app_name: string): [boolean, string, number, number]

  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.

  Parameters

  • app_name: string

    the name of the application that has registered this item

  Returns [boolean, string, number, number]

  true if an application with app_name has registered this resource inside the recently used list, or false otherwise. The app_exec string is owned by the Gtk.RecentInfo and should not be modified or freed

get_applications

• get_applications(): string[]

  Retrieves the list of applications that have registered this resource.

  Returns string[]

  a newly allocated null-terminated array of strings. Use g_strfreev() to free it.

get_description

• get_description(): string

  Gets the (short) description of the resource.

  Returns string

  the description of the resource. The returned string is owned by the recent manager, and should not be freed.

get_display_name

• get_display_name(): string

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

  Returns string

  the display name of the resource. The returned string is owned by the recent manager, and should not be freed.

get_gicon

• get_gicon(): Gio.Icon

  Retrieves the icon associated to the resource MIME type.

  Returns Gio.Icon

  a Gio.Icon containing the icon, or null. Use g_object_unref() when finished using the icon

get_groups

• get_groups(): string[]

  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.

  Returns string[]

  a newly allocated null terminated array of strings. Use g_strfreev() to free it.

get_icon

• get_icon(size: number): GdkPixbuf.Pixbuf

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

  Parameters

  • size: number

    the size of the icon in pixels

  Returns GdkPixbuf.Pixbuf

  a GdkPixbuf.Pixbuf containing the icon, or null. Use g_object_unref() when finished using the icon.

get_mime_type

• get_mime_type(): string

  Gets the MIME type of the resource.

  Returns string

  the MIME type of the resource. The returned string is owned by the recent manager, and should not be freed.

get_modified

• get_modified(): number

  Gets the timestamp (seconds from system’s Epoch) when the meta-data for the resource was last modified.

  Returns number

  the number of seconds elapsed from system’s Epoch when the resource was last modified, or -1 on failure.

get_private_hint

• get_private_hint(): boolean

  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.

  Returns boolean

  true if the private flag was found, false otherwise

get_short_name

• get_short_name(): string

  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”.

  Returns string

  A newly-allocated string in UTF-8 encoding free it with g_free()

get_uri

• get_uri(): string

  Gets the URI of the resource.

  Returns string

  the URI of the resource. The returned string is owned by the recent manager, and should not be freed.

get_uri_display

• get_uri_display(): string

  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().

  Returns string

  a newly allocated UTF-8 string containing the resource’s URI or null. Use g_free() when done using it.

get_visited

• get_visited(): number

  Gets the timestamp (seconds from system’s Epoch) when the meta-data for the resource was last visited.

  Returns number

  the number of seconds elapsed from system’s Epoch when the resource was last visited, or -1 on failure.

has_application

• has_application(app_name: string): boolean

  Checks whether an application registered this resource using app_name.

  Parameters

  • app_name: string

    a string containing an application name

  Returns boolean

  true if an application with name app_name was found, false otherwise

has_group

• has_group(group_name: string): boolean

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

  Parameters

  • group_name: string

    name of a group

  Returns boolean

  true if the group was found

is_local

• is_local(): boolean

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

  Returns boolean

  true if the resource is local

last_application

• last_application(): string

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

  Returns string

  an application name. Use g_free() to free it.

match

• match(info_b: Gtk.RecentInfo): boolean

  Checks whether two Gtk.RecentInfo-struct point to the same resource.

  Parameters

  • info_b: Gtk.RecentInfo

    a Gtk.RecentInfo

  Returns boolean

  true if both Gtk.RecentInfo-struct point to the same resource, false otherwise

ref

• ref(): Gtk.RecentInfo

  Increases the reference count of recent_info by one.

  Returns Gtk.RecentInfo

  the recent info object with its reference count increased by one

unref

• unref(): void

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

  Returns void