// 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 glib::object::ObjectType as ObjectType_;
use glib::signal::connect_raw;
use glib::signal::SignalHandlerId;
use glib::translate::*;
use std::boxed::Box as Box_;
use std::fmt;
use std::mem::transmute;

glib::wrapper! {
    /// [`AppInfoMonitor`][crate::AppInfoMonitor] is a very simple object used for monitoring the app
    /// info database for changes (ie: newly installed or removed
    /// applications).
    ///
    /// Call [`get()`][Self::get()] to get a [`AppInfoMonitor`][crate::AppInfoMonitor] and connect
    /// to the "changed" signal.
    ///
    /// 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 [`AppInfo`][crate::AppInfo] APIs
    /// in response to the change signal, deferring these until the time that
    /// the data is actually required. The exception to this case is when
    /// application information is actually being displayed on the screen
    /// (eg: 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.
    ///
    /// # 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 [`AppInfoMonitor`][crate::AppInfoMonitor] for the current thread-default main
    /// context.
    ///
    /// The [`AppInfoMonitor`][crate::AppInfoMonitor] will emit a "changed" signal in the
    /// thread-default main context whenever the list of installed
    /// applications (as reported by [`AppInfo::all()`][crate::AppInfo::all()]) may have changed.
    ///
    /// 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 [`AppInfoMonitor`][crate::AppInfoMonitor]
    #[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 for changes (ie: newly installed
    /// or removed applications).
    #[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(transmute::<_, unsafe extern "C" fn()>(
                    changed_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl fmt::Display for AppInfoMonitor {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        f.write_str("AppInfoMonitor")
    }
}