gio/auto/

dbus_object_manager.rs

// 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, DBusInterface, DBusObject};
use glib::{
    prelude::*,
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::boxed::Box as Box_;

glib::wrapper! {
    /// The `GDBusObjectManager` type is the base type for service- and
    /// client-side implementations of the standardized
    /// [`org.freedesktop.DBus.ObjectManager`](http://dbus.freedesktop.org/doc/dbus-specification.html#standard-interfaces-objectmanager)
    /// interface.
    ///
    /// See `Gio::DBusObjectManagerClient` for the client-side implementation
    /// and `Gio::DBusObjectManagerServer` for the service-side implementation.
    ///
    /// ## Signals
    ///
    ///
    /// #### `interface-added`
    ///  Emitted when @interface is added to @object.
    ///
    /// This signal exists purely as a convenience to avoid having to
    /// connect signals to all objects managed by @manager.
    ///
    ///
    ///
    ///
    /// #### `interface-removed`
    ///  Emitted when @interface has been removed from @object.
    ///
    /// This signal exists purely as a convenience to avoid having to
    /// connect signals to all objects managed by @manager.
    ///
    ///
    ///
    ///
    /// #### `object-added`
    ///  Emitted when @object is added to @manager.
    ///
    ///
    ///
    ///
    /// #### `object-removed`
    ///  Emitted when @object is removed from @manager.
    ///
    ///
    ///
    /// # Implements
    ///
    /// [`DBusObjectManagerExt`][trait@crate::prelude::DBusObjectManagerExt]
    #[doc(alias = "GDBusObjectManager")]
    pub struct DBusObjectManager(Interface<ffi::GDBusObjectManager, ffi::GDBusObjectManagerIface>);

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

impl DBusObjectManager {
    pub const NONE: Option<&'static DBusObjectManager> = None;
}

/// Trait containing all [`struct@DBusObjectManager`] methods.
///
/// # Implementors
///
/// [`DBusObjectManager`][struct@crate::DBusObjectManager]
pub trait DBusObjectManagerExt: IsA<DBusObjectManager> + 'static {
    /// Gets the interface proxy for @interface_name at @object_path, if
    /// any.
    /// ## `object_path`
    /// Object path to look up.
    /// ## `interface_name`
    /// D-Bus interface name to look up.
    ///
    /// # Returns
    ///
    /// A #GDBusInterface instance or [`None`]. Free
    ///   with g_object_unref().
    #[doc(alias = "g_dbus_object_manager_get_interface")]
    #[doc(alias = "get_interface")]
    fn interface(&self, object_path: &str, interface_name: &str) -> Option<DBusInterface> {
        unsafe {
            from_glib_full(ffi::g_dbus_object_manager_get_interface(
                self.as_ref().to_glib_none().0,
                object_path.to_glib_none().0,
                interface_name.to_glib_none().0,
            ))
        }
    }

    /// Gets the #GDBusObject at @object_path, if any.
    /// ## `object_path`
    /// Object path to look up.
    ///
    /// # Returns
    ///
    /// A #GDBusObject or [`None`]. Free with
    ///   g_object_unref().
    #[doc(alias = "g_dbus_object_manager_get_object")]
    #[doc(alias = "get_object")]
    fn object(&self, object_path: &str) -> Option<DBusObject> {
        unsafe {
            from_glib_full(ffi::g_dbus_object_manager_get_object(
                self.as_ref().to_glib_none().0,
                object_path.to_glib_none().0,
            ))
        }
    }

    /// Gets the object path that @self is for.
    ///
    /// # Returns
    ///
    /// A string owned by @self. Do not free.
    #[doc(alias = "g_dbus_object_manager_get_object_path")]
    #[doc(alias = "get_object_path")]
    fn object_path(&self) -> glib::GString {
        unsafe {
            from_glib_none(ffi::g_dbus_object_manager_get_object_path(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Gets all #GDBusObject objects known to @self.
    ///
    /// # Returns
    ///
    /// A list of
    ///   #GDBusObject objects. The returned list should be freed with
    ///   g_list_free() after each element has been freed with
    ///   g_object_unref().
    #[doc(alias = "g_dbus_object_manager_get_objects")]
    #[doc(alias = "get_objects")]
    fn objects(&self) -> Vec<DBusObject> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::g_dbus_object_manager_get_objects(
                self.as_ref().to_glib_none().0,
            ))
        }
    }

    /// Emitted when @interface is added to @object.
    ///
    /// This signal exists purely as a convenience to avoid having to
    /// connect signals to all objects managed by @manager.
    /// ## `object`
    /// The #GDBusObject on which an interface was added.
    /// ## `interface`
    /// The #GDBusInterface that was added.
    #[doc(alias = "interface-added")]
    fn connect_interface_added<F: Fn(&Self, &DBusObject, &DBusInterface) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn interface_added_trampoline<
            P: IsA<DBusObjectManager>,
            F: Fn(&P, &DBusObject, &DBusInterface) + 'static,
        >(
            this: *mut ffi::GDBusObjectManager,
            object: *mut ffi::GDBusObject,
            interface: *mut ffi::GDBusInterface,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(
                DBusObjectManager::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(object),
                &from_glib_borrow(interface),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"interface-added\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    interface_added_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// Emitted when @interface has been removed from @object.
    ///
    /// This signal exists purely as a convenience to avoid having to
    /// connect signals to all objects managed by @manager.
    /// ## `object`
    /// The #GDBusObject on which an interface was removed.
    /// ## `interface`
    /// The #GDBusInterface that was removed.
    #[doc(alias = "interface-removed")]
    fn connect_interface_removed<F: Fn(&Self, &DBusObject, &DBusInterface) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn interface_removed_trampoline<
            P: IsA<DBusObjectManager>,
            F: Fn(&P, &DBusObject, &DBusInterface) + 'static,
        >(
            this: *mut ffi::GDBusObjectManager,
            object: *mut ffi::GDBusObject,
            interface: *mut ffi::GDBusInterface,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(
                DBusObjectManager::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(object),
                &from_glib_borrow(interface),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"interface-removed\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    interface_removed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// Emitted when @object is added to @manager.
    /// ## `object`
    /// The #GDBusObject that was added.
    #[doc(alias = "object-added")]
    fn connect_object_added<F: Fn(&Self, &DBusObject) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn object_added_trampoline<
            P: IsA<DBusObjectManager>,
            F: Fn(&P, &DBusObject) + 'static,
        >(
            this: *mut ffi::GDBusObjectManager,
            object: *mut ffi::GDBusObject,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(
                DBusObjectManager::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(object),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"object-added\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    object_added_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    /// Emitted when @object is removed from @manager.
    /// ## `object`
    /// The #GDBusObject that was removed.
    #[doc(alias = "object-removed")]
    fn connect_object_removed<F: Fn(&Self, &DBusObject) + 'static>(&self, f: F) -> SignalHandlerId {
        unsafe extern "C" fn object_removed_trampoline<
            P: IsA<DBusObjectManager>,
            F: Fn(&P, &DBusObject) + 'static,
        >(
            this: *mut ffi::GDBusObjectManager,
            object: *mut ffi::GDBusObject,
            f: glib::ffi::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(
                DBusObjectManager::from_glib_borrow(this).unsafe_cast_ref(),
                &from_glib_borrow(object),
            )
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"object-removed\0".as_ptr() as *const _,
                Some(std::mem::transmute::<*const (), unsafe extern "C" fn()>(
                    object_removed_trampoline::<Self, F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl<O: IsA<DBusObjectManager>> DBusObjectManagerExt for O {}