Struct gtk::RecentInfo

pub struct RecentInfo(_);

RecentInfo-struct contains private data only, and should be accessed using the provided API.

RecentInfo constains all the meta-data associated with an entry in the recently used files list.

Implementations

impl RecentInfo

pub fn create_app_info(
    &self,
    app_name: Option<&str>
) -> Result<Option<AppInfo>, Error>

Creates a gio::AppInfo for the specified RecentInfo

app_name

the name of the application that should be mapped to a gio::AppInfo; if None is used then the default application for the MIME type is used

Returns

the newly created gio::AppInfo, or None. In case of error, error will be set either with a GTK_RECENT_MANAGER_ERROR or a G_IO_ERROR

pub fn exists(&self) -> bool

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

Returns

true if the resource exists

pub fn get_added(&self) -> c_long

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

Returns

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

pub fn get_age(&self) -> i32

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

Returns

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

pub fn get_application_info(
    &self,
    app_name: &str
) -> Option<(GString, u32, c_long)>

Gets the data regarding the application that has registered the resource pointed by self.

If the command line contains any escape characters defined inside the storage specification, they will be expanded.

app_name

the name of the application that has registered this item

app_exec

return location for the string containing the command line

count

return location for the number of times this item was registered

time_

return location for the timestamp this item was last registered for this application

Returns

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 RecentInfo and should not be modified or freed

pub fn get_applications(&self) -> Vec<GString>

Retrieves the list of applications that have registered this resource.

length

return location for the length of the returned list

Returns

a newly allocated None-terminated array of strings. Use g_strfreev to free it.

pub fn get_description(&self) -> Option<GString>

Gets the (short) description of the resource.

Returns

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

pub fn get_display_name(&self) -> Option<GString>

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

Returns

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

pub fn get_gicon(&self) -> Option<Icon>

Retrieves the icon associated to the resource MIME type.

Returns

a gio::Icon containing the icon, or None. Use gobject::ObjectExt::unref when finished using the icon

pub fn get_groups(&self) -> Vec<GString>

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

length

return location for the number of groups returned

Returns

a newly allocated None terminated array of strings. Use g_strfreev to free it.

pub fn get_icon(&self, size: i32) -> Option<Pixbuf>

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

size

the size of the icon in pixels

Returns

a gdk_pixbuf::Pixbuf containing the icon, or None. Use gobject::ObjectExt::unref when finished using the icon.

pub fn get_mime_type(&self) -> Option<GString>

Gets the MIME type of the resource.

Returns

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

pub fn get_modified(&self) -> c_long

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

Returns

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

pub fn get_private_hint(&self) -> bool

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

true if the private flag was found, false otherwise

pub fn get_short_name(&self) -> Option<GString>

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

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

pub fn get_uri(&self) -> Option<GString>

Gets the URI of the resource.

Returns

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

pub fn get_uri_display(&self) -> Option<GString>

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 RecentInfo::get_uri.

Returns

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

pub fn get_visited(&self) -> c_long

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

Returns

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

pub fn has_application(&self, app_name: &str) -> bool

Checks whether an application registered this resource using app_name.

app_name

a string containing an application name

Returns

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

pub fn has_group(&self, group_name: &str) -> bool

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

group_name

name of a group

Returns

true if the group was found

pub fn is_local(&self) -> bool

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

Returns

true if the resource is local

pub fn last_application(&self) -> Option<GString>

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

Returns

an application name. Use g_free to free it.

pub fn match_(&self, info_b: &RecentInfo) -> bool

Trait Implementations

impl Clone for RecentInfo

fn clone(&self) -> RecentInfo

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RecentInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for RecentInfo

impl Hash for RecentInfo

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given [Hasher].

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given [Hasher].

impl Ord for RecentInfo

fn cmp(&self, other: &RecentInfo) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<RecentInfo> for RecentInfo

fn eq(&self, other: &RecentInfo) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &RecentInfo) -> bool

This method tests for !=.

impl PartialOrd<RecentInfo> for RecentInfo

fn partial_cmp(&self, other: &RecentInfo) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &RecentInfo) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &RecentInfo) -> bool

This method tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &RecentInfo) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &RecentInfo) -> bool

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for RecentInfo

fn static_type() -> Type

Returns the type identifier of Self.

impl StructuralEq for RecentInfo

impl StructuralPartialEq for RecentInfo