Struct gtk::RecentFilter

pub struct RecentFilter(_, _);

A RecentFilter can be used to restrict the files being shown in a RecentChooser. Files can be filtered based on their name (with RecentFilter::add_pattern), on their mime type (with FileFilter::add_mime_type), on the application that has registered them (with RecentFilter::add_application), or by a custom filter function (with RecentFilter::add_custom).

Filtering by mime type handles aliasing and subclassing of mime types; e.g. a filter for text/plain also matches a file with mime type application/rtf, since application/rtf is a subclass of text/plain. Note that RecentFilter allows wildcards for the subtype of a mime type, so you can e.g. filter for image/*.

Normally, filters are used by adding them to a RecentChooser, see RecentChooser::add_filter, but it is also possible to manually use a filter on a file with RecentFilter::filter.

Recently used files are supported since GTK+ 2.10.

RecentFilter as Buildable

The RecentFilter implementation of the Buildable interface supports adding rules using the <mime-types>, <patterns> and <applications> elements and listing the rules within. Specifying a <mime-type>, <pattern> or <application> has the same effect as calling RecentFilter::add_mime_type, RecentFilter::add_pattern or RecentFilter::add_application.

An example of a UI definition fragment specifying RecentFilter rules:

<object class="GtkRecentFilter">
  <mime-types>
    <mime-type>text/plain</mime-type>
    <mime-type>image/png</mime-type>
  </mime-types>
  <patterns>
    <pattern>*.txt</pattern>
    <pattern>*.png</pattern>
  </patterns>
  <applications>
    <application>gimp</application>
    <application>gedit</application>
    <application>glade</application>
  </applications>
</object>

Implements

glib::object::ObjectExt, BuildableExt, BuildableExtManual

Implementations

impl RecentFilter

pub fn new() -> RecentFilter

Creates a new RecentFilter with no rules added to it. Such filter does not accept any recently used resources, so is not particularly useful until you add rules with RecentFilter::add_pattern, RecentFilter::add_mime_type, RecentFilter::add_application, RecentFilter::add_age. To create a filter that accepts any recently used resource, use:

GtkRecentFilter *filter = gtk_recent_filter_new ();
gtk_recent_filter_add_pattern (filter, "*");

Returns

a new RecentFilter

pub fn add_age(&self, days: i32)

Adds a rule that allows resources based on their age - that is, the number of days elapsed since they were last modified.

days

number of days

pub fn add_application(&self, application: &str)

Adds a rule that allows resources based on the name of the application that has registered them.

application

an application name

pub fn add_group(&self, group: &str)

Adds a rule that allows resources based on the name of the group to which they belong

group

a group name

pub fn add_mime_type(&self, mime_type: &str)

Adds a rule that allows resources based on their registered MIME type.

mime_type

a MIME type

pub fn add_pattern(&self, pattern: &str)

Adds a rule that allows resources based on a pattern matching their display name.

pattern

a file pattern

pub fn add_pixbuf_formats(&self)

Adds a rule allowing image files in the formats supported by gdk_pixbuf::Pixbuf.

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

Gets the human-readable name for the filter. See RecentFilter::set_name.

Returns

the name of the filter, or None. The returned string is owned by the filter object and should not be freed.

pub fn get_needed(&self) -> RecentFilterFlags

Gets the fields that need to be filled in for the RecentFilterInfo passed to RecentFilter::filter

This function will not typically be used by applications; it is intended principally for use in the implementation of RecentChooser.

Returns

bitfield of flags indicating needed fields when calling RecentFilter::filter

pub fn set_name(&self, name: &str)

Sets the human-readable name of the filter; this is the string that will be displayed in the recently used resources selector user interface if there is a selectable list of filters.

name

then human readable name of self

Trait Implementations

impl Clone for RecentFilter

fn clone(&self) -> RecentFilter

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RecentFilter

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

Formats the value using the given formatter.

impl Default for RecentFilter

fn default() -> Self

Returns the "default value" for a type.

impl Display for RecentFilter

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

Formats the value using the given formatter.

impl Eq for RecentFilter

impl Hash for RecentFilter

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 IsA<Buildable> for RecentFilter

impl Ord for RecentFilter

fn cmp(&self, other: &RecentFilter) -> 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<T: ObjectType> PartialEq<T> for RecentFilter

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

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

#[must_use]fn ne(&self, other: &Rhs) -> bool

This method tests for !=.

impl<T: ObjectType> PartialOrd<T> for RecentFilter

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

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

#[must_use]fn lt(&self, other: &Rhs) -> bool

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

#[must_use]fn le(&self, other: &Rhs) -> bool

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

#[must_use]fn gt(&self, other: &Rhs) -> bool

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

#[must_use]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 RecentFilter

fn static_type() -> Type

Returns the type identifier of Self.