Struct gtk4::RecentManager

#[repr(transparent)]
pub struct RecentManager { /* private fields */ }

RecentManager manages and looks 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 recently used files list is per user.

RecentManager acts like a database of all the recently used files. You can create new RecentManager objects, but it is more efficient to use the default manager created by GTK.

Adding a new recently used file is as simple as:

⚠️ The following code is in c ⚠️

GtkRecentManager *manager;

manager = gtk_recent_manager_get_default ();
gtk_recent_manager_add_item (manager, file_uri);

The RecentManager will try to gather all the needed information from the file itself through GIO.

Looking up the meta-data associated with a recently used file given its URI requires calling RecentManagerExt::lookup_item():

⚠️ The following code is in c ⚠️

GtkRecentManager *manager;
GtkRecentInfo *info;
GError *error = NULL;

manager = gtk_recent_manager_get_default ();
info = gtk_recent_manager_lookup_item (manager, file_uri, &error);
if (error)
  {
    g_warning ("Could not find the file: %s", error->message);
    g_error_free (error);
  }
else
 {
   // Use the info object
   gtk_recent_info_unref (info);
 }

In order to retrieve the list of recently used files, you can use RecentManagerExt::items(), which returns a list of RecentInfo.

Note that the maximum age of the recently used files list is controllable through the gtk-recent-files-max-age property.

Properties

filename

The full path to the file to be used to store and read the recently used resources list

Readable | Writeable | Construct Only

size

The size of the recently used resources list.

Readable

Signals

changed

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

This can happen either by calling RecentManagerExt::add_item() or by another application.

Implements

RecentManagerExt, glib::ObjectExt

Implementations

impl RecentManager

pub const NONE: Option<&'static RecentManager> = None

pub fn new() -> RecentManager

Creates a new recent manager object.

Recent manager objects are used to handle the list of recently used resources. A RecentManager object monitors the recently used resources list, and emits the changed signal each time something inside the list changes.

RecentManager objects are expensive: be sure to create them only when needed. You should use default() instead.

Returns

A newly created RecentManager object

pub fn default() -> RecentManager

Gets a unique instance of RecentManager that you can share in your application without caring about memory management.

Returns

A unique RecentManager. Do not ref or unref it.

Trait Implementations

impl Clone for RecentManager

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RecentManager

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

Formats the value using the given formatter.

impl Default for RecentManager

fn default() -> Self

Returns the “default value” for a type.

impl Display for RecentManager

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

Formats the value using the given formatter.

impl HasParamSpec for RecentManager

type ParamSpec = ParamSpecObject

type SetValue = RecentManager

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, RecentManager>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for RecentManager

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

Feeds this value into the given Hasher.

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

Feeds a slice of this type into the given Hasher.

impl<T: RecentManagerImpl> IsSubclassable<T> for RecentManager

fn class_init(class: &mut Class<Self>)

Override the virtual methods of this class for the given subclass and do other class initialization.

fn instance_init(instance: &mut InitializingObject<T>)

Instance specific initialization.

impl Ord for RecentManager

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

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Selfwhere Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Selfwhere Self: Sized + PartialOrd<Self>,

Restrict a value to a certain interval.

impl ParentClassIs for RecentManager

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for RecentManager

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

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

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for RecentManager

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

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

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

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

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

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

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

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

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

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

impl StaticType for RecentManager

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for RecentManager