Struct gio::AppInfoMonitor

pub struct AppInfoMonitor { /* private fields */ }

GAppInfoMonitor monitors application information for changes.

GAppInfoMonitor is a very simple object used for monitoring the app info database for changes (newly installed or removed applications).

Call get() to get a GAppInfoMonitor and connect to the changed signal. The signal will be emitted once when the app info database changes, and will not be emitted again until after the next call to AppInfo::all() or another g_app_info_*() function. This is because monitoring the app info database for changes is expensive.

The following functions will re-arm the changed signal so it can be emitted again:

• AppInfo::all()
• AppInfo::all_for_type()
• AppInfo::default_for_type()
• AppInfo::fallback_for_type()
• AppInfo::recommended_for_type()
• g_desktop_app_info_get_implementations()
• g_desktop_app_info_new()
• g_desktop_app_info_new_from_filename()
• g_desktop_app_info_new_from_keyfile()
• g_desktop_app_info_search()

The latter functions are available if using GDesktopAppInfo from gio-unix-2.0.pc (GIR namespace GioUnix-2.0).

In the usual case, applications should try to make note of the change (doing things like invalidating caches) but not act on it. In particular, applications should avoid making calls to GAppInfo APIs in response to the change signal, deferring these until the time that the updated data is actually required. The exception to this case is when application information is actually being displayed on the screen (for example, during a search or when the list of all applications is shown). The reason for this is that changes to the list of installed applications often come in groups (like during system updates) and rescanning the list on every change is pointless and expensive.

Signals

changed

Signal emitted when the app info database changes, when applications are installed or removed.

Implements

[trait@glib::ObjectExt]

Implementations

impl AppInfoMonitor

pub fn get() -> AppInfoMonitor

Gets the #GAppInfoMonitor for the current thread-default main context.

The #GAppInfoMonitor will emit a “changed” signal in the thread-default main context whenever the list of installed applications (as reported by g_app_info_get_all()) may have changed.

The #GAppInfoMonitor::changed signal will only be emitted once until g_app_info_get_all() (or another g_app_info_*() function) is called. Doing so will re-arm the signal ready to notify about the next change.

You must only call g_object_unref() on the return value from under the same main context as you created it.

Returns

a reference to a #GAppInfoMonitor

pub fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId

Signal emitted when the app info database changes, when applications are installed or removed.

Trait Implementations

impl Clone for AppInfoMonitor

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 AppInfoMonitor

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

Formats the value using the given formatter.

impl HasParamSpec for AppInfoMonitor

type ParamSpec = ParamSpecObject

type SetValue = AppInfoMonitor

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

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

fn param_spec_builder() -> Self::BuilderFn

impl Hash for AppInfoMonitor

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 Ord for AppInfoMonitor

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

This method returns an Ordering between self and other.

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

where Self: Sized,

Compares and returns the maximum of two values.

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

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl ParentClassIs for AppInfoMonitor

type Parent = Object

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

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 AppInfoMonitor

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 AppInfoMonitor

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for AppInfoMonitor