Trait gtk4::prelude::RecentManagerExt

source ·

pub trait RecentManagerExt: IsA<RecentManager> + Sealed + 'static {
    // Provided methods
    fn add_full(&self, uri: &str, recent_data: &RecentData) -> bool { ... }
    fn add_item(&self, uri: &str) -> bool { ... }
    fn items(&self) -> Vec<RecentInfo> { ... }
    fn has_item(&self, uri: &str) -> bool { ... }
    fn lookup_item(&self, uri: &str) -> Result<Option<RecentInfo>, Error> { ... }
    fn move_item(&self, uri: &str, new_uri: Option<&str>) -> Result<(), Error> { ... }
    fn purge_items(&self) -> Result<i32, Error> { ... }
    fn remove_item(&self, uri: &str) -> Result<(), Error> { ... }
    fn filename(&self) -> Option<GString> { ... }
    fn size(&self) -> i32 { ... }
    fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId { ... }
    fn connect_size_notify<F: Fn(&Self) + 'static>(
        &self,
        f: F
    ) -> SignalHandlerId { ... }
}

Expand description

Trait containing all RecentManager methods.

§Implementors

RecentManager

Provided Methods§

source

fn add_full(&self, uri: &str, recent_data: &RecentData) -> bool

Adds a new resource, pointed by @uri, into the recently used resources list, using the metadata specified inside the RecentData passed in @recent_data.

The passed URI will be used to identify this resource inside the list.

In order to register the new recently used resource, metadata about the resource must be passed as well as the URI; the metadata is stored in a RecentData, which must contain the MIME type of the resource pointed by the URI; the name of the application that is registering the item, and a command line to be used when launching the item.

Optionally, a RecentData might contain a UTF-8 string to be used when viewing the item instead of the last component of the URI; a short description of the item; whether the item should be considered private - that is, should be displayed only by the applications that have registered it.

§`uri`

a valid URI

§`recent_data`

metadata of the resource

§Returns

true if the new item was successfully added to the recently used resources list, false otherwise

source

fn add_item(&self, uri: &str) -> bool

Adds a new resource, pointed by @uri, into the recently used resources list.

This function automatically retrieves some of the needed metadata and setting other metadata to common default values; it then feeds the data to add_full().

See add_full() if you want to explicitly define the metadata for the resource pointed by @uri.

§`uri`

a valid URI

§Returns

true if the new item was successfully added to the recently used resources list

source

fn items(&self) -> Vec<RecentInfo>

Gets the list of recently used resources.

§Returns

a list of newly allocated GtkRecentInfo objects. Use Gtk::RecentInfo::unref() on each item inside the list, and then free the list itself using g_list_free().

source

fn has_item(&self, uri: &str) -> bool

Checks whether there is a recently used resource registered with @uri inside the recent manager.

§`uri`

a URI

§Returns

true if the resource was found, false otherwise

source

fn lookup_item(&self, uri: &str) -> Result<Option<RecentInfo>, Error>

Searches for a URI inside the recently used resources list, and returns a RecentInfo containing information about the resource like its MIME type, or its display name.

§`uri`

a URI

§Returns

a RecentInfo containing information about the resource pointed by @uri, or None if the URI was not registered in the recently used resources list. Free with Gtk::RecentInfo::unref().

source