gio/auto/
app_info_monitor.rs

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use crate::ffi;
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// `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()`][Self::get()] to get a `GAppInfoMonitor` and connect
    /// to the [`changed`][struct@crate::AppInfoMonitor#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()`][crate::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`][struct@crate::AppInfoMonitor#changed]
    /// signal so it can be emitted again:
    ///
    ///  - [`AppInfo::all()`][crate::AppInfo::all()]
    ///  - [`AppInfo::all_for_type()`][crate::AppInfo::all_for_type()]
    ///  - [`AppInfo::default_for_type()`][crate::AppInfo::default_for_type()]
    ///  - [`AppInfo::fallback_for_type()`][crate::AppInfo::fallback_for_type()]
    ///  - [`AppInfo::recommended_for_type()`][crate::AppInfo::recommended_for_type()]
    ///  - [`g_desktop_app_info_get_implementations()`](../gio-unix/type_func.DesktopAppInfo.get_implementation.html)
    ///  - [`g_desktop_app_info_new()`](../gio-unix/ctor.DesktopAppInfo.new.html)
    ///  - [`g_desktop_app_info_new_from_filename()`](../gio-unix/ctor.DesktopAppInfo.new_from_filename.html)
    ///  - [`g_desktop_app_info_new_from_keyfile()`](../gio-unix/ctor.DesktopAppInfo.new_from_keyfile.html)
    ///  - [`g_desktop_app_info_search()`](../gio-unix/type_func.DesktopAppInfo.search.html)
    ///
    /// The latter functions are available if using
    /// [`GDesktopAppInfo`](../gio-unix/class.DesktopAppInfo.html) 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`]
    #[doc(alias = "GAppInfoMonitor")]
    pub struct AppInfoMonitor(Object<ffi::GAppInfoMonitor>);

    match fn {
        type_ => || ffi::g_app_info_monitor_get_type(),
    }
}

impl 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
    #[doc(alias = "g_app_info_monitor_get")]
    pub fn get() -> AppInfoMonitor {
        unsafe { from_glib_full(ffi::g_app_info_monitor_get()) }
    }

    /// Signal emitted when the app info database changes, when applications are
    /// installed or removed.
    #[doc(alias = "changed")]
    pub fn connect_changed<F: Fn(&Self) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn changed_trampoline<F: Fn(&AppInfoMonitor) + 'static>(
            this: *mut ffi::GAppInfoMonitor,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"changed\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    changed_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}