glibmm 2.78.1
Public Member Functions | Static Public Member Functions | Public Attributes | Protected Member Functions | Related Symbols | List of all members
Gio::DBus::Object Class Reference

Object - Base type for D-Bus objects. More...

#include <giomm/dbusobject.h>

Inheritance diagram for Gio::DBus::Object:
Inheritance graph
[legend]

Public Member Functions

 Object (Object &&src) noexcept
 
Objectoperator= (Object &&src) noexcept
 
 ~Object () noexcept override
 
GDBusObjectgobj ()
 Provides access to the underlying C GObject.
 
const GDBusObjectgobj () const
 Provides access to the underlying C GObject.
 
Glib::ustring get_object_path () const
 Gets the object path for object.
 
std::vector< Glib::RefPtr< Gio::DBus::Interface > > get_interfaces ()
 Gets the D-Bus interfaces associated with object.
 
std::vector< Glib::RefPtr< const Gio::DBus::Interface > > get_interfaces () const
 Gets the D-Bus interfaces associated with object.
 
Glib::RefPtr< Gio::DBus::Interfaceget_interface (const Glib::ustring &interface_name)
 Gets the D-Bus interface with name interface_name associated with object, if any.
 
Glib::RefPtr< const Gio::DBus::Interfaceget_interface (const Glib::ustring &interface_name) const
 Gets the D-Bus interface with name interface_name associated with object, if any.
 
- Public Member Functions inherited from Glib::Interface
 Interface ()
 A Default constructor.
 
 Interface (Interface &&src) noexcept
 
Interfaceoperator= (Interface &&src) noexcept
 
 Interface (const Glib::Interface_Class &interface_class)
 Called by constructors of derived classes.
 
 Interface (GObject *castitem)
 Called by constructors of derived classes.
 
 ~Interface () noexcept override
 
 Interface (const Interface &)=delete
 
Interfaceoperator= (const Interface &)=delete
 
GObject * gobj ()
 
const GObject * gobj () const
 
- Public Member Functions inherited from Glib::ObjectBase
 ObjectBase (const ObjectBase &)=delete
 
ObjectBaseoperator= (const ObjectBase &)=delete
 
void set_property_value (const Glib::ustring & property_name, const Glib::ValueBase & value)
 You probably want to use a specific property_*() accessor method instead.
 
void get_property_value (const Glib::ustring & property_name, Glib::ValueBase & value) const
 You probably want to use a specific property_*() accessor method instead.
 
template<class PropertyType >
void set_property (const Glib::ustring & property_name, const PropertyType & value)
 You probably want to use a specific property_*() accessor method instead.
 
template<class PropertyType >
void get_property (const Glib::ustring & property_name, PropertyType & value) const
 You probably want to use a specific property_*() accessor method instead.
 
template<class PropertyType >
PropertyType get_property (const Glib::ustring & property_name) const
 You probably want to use a specific property_*() accessor method instead.
 
sigc::connection connect_property_changed (const Glib::ustring & property_name, const sigc::slot< void()> &slot)
 You can use the signal_changed() signal of the property proxy instead.
 
sigc::connection connect_property_changed (const Glib::ustring & property_name, sigc::slot< void()> &&slot)
 You can use the signal_changed() signal of the property proxy instead.
 
void freeze_notify ()
 Increases the freeze count on object.
 
void thaw_notify ()
 Reverts the effect of a previous call to freeze_notify().
 
virtual void reference () const
 Increment the reference count for this object.
 
virtual void unreference () const
 Decrement the reference count for this object.
 
GObject * gobj ()
 Provides access to the underlying C GObject.
 
const GObject * gobj () const
 Provides access to the underlying C GObject.
 
GObject * gobj_copy () const
 Give a ref-ed copy to someone. Use for direct struct access.
 

Static Public Member Functions

static void add_interface (GType gtype_implementer)
 
static GType get_type ()
 Get the GType for this class, for use with the underlying GObject type system.
 

Public Attributes

Glib::SignalProxy< void(const Glib::RefPtr< Gio::DBus::Interface > &) signal_interface_added )()
 
Glib::SignalProxy< void(const Glib::RefPtr< Gio::DBus::Interface > &) signal_interface_removed )()
 

Protected Member Functions

 Object ()
 You should derive from this class to use it.
 
virtual Glib::ustring get_object_path_vfunc () const
 
virtual std::vector< Glib::RefPtr< Gio::DBus::Interface > > get_interfaces_vfunc () const
 
virtual Glib::RefPtr< Gio::DBus::Interfaceget_interface_vfunc (const Glib::ustring &interface_name) const
 
virtual void on_interface_added (const Glib::RefPtr< Gio::DBus::Interface > &iface)
 This is a default handler for the signal signal_interface_added().
 
virtual void on_interface_removed (const Glib::RefPtr< Gio::DBus::Interface > &iface)
 This is a default handler for the signal signal_interface_removed().
 
- Protected Member Functions inherited from Glib::ObjectBase
 ObjectBase ()
 This default constructor is called implicitly from the constructor of user-derived classes, even if, for instance, Gtk::Button calls a different ObjectBase constructor.
 
 ObjectBase (const char *custom_type_name)
 A derived constructor always overrides this choice.
 
 ObjectBase (const std::type_info &custom_type_info)
 This constructor is a special feature to allow creation of derived types on the fly, without having to use g_object_new() manually.
 
 ObjectBase (ObjectBase &&src) noexcept
 
ObjectBaseoperator= (ObjectBase &&src) noexcept
 
virtual ~ObjectBase () noexcept=0
 
void initialize (GObject *castitem)
 
void initialize_move (GObject *castitem, Glib::ObjectBase *previous_wrapper)
 

Related Symbols

(Note that these are not member symbols.)

Glib::RefPtr< Gio::DBus::Objectwrap (GDBusObject *object, bool take_copy=false)
 A Glib::wrap() method for this object.
 

Detailed Description

Object - Base type for D-Bus objects.

The Object type is the base type for D-Bus objects on both the service side (see ObjectSkeleton) and the client side (see ObjectProxy). It is essentially just a container of interfaces.

Since glibmm 2.34

Constructor & Destructor Documentation

◆ Object() [1/2]

Gio::DBus::Object::Object ( )
protected

You should derive from this class to use it.

◆ Object() [2/2]

Gio::DBus::Object::Object ( Object && src)
noexcept

◆ ~Object()

Gio::DBus::Object::~Object ( )
overridenoexcept

Member Function Documentation

◆ add_interface()

static void Gio::DBus::Object::add_interface ( GType gtype_implementer)
static

◆ get_interface() [1/2]

Glib::RefPtr< Gio::DBus::Interface > Gio::DBus::Object::get_interface ( const Glib::ustring & interface_name)

Gets the D-Bus interface with name interface_name associated with object, if any.

Since glibmm 2.30
Parameters
interface_nameA D-Bus interface name.
Returns
nullptr if not found, otherwise a DBusInterface that must be freed with Glib::object_unref().

◆ get_interface() [2/2]

Glib::RefPtr< const Gio::DBus::Interface > Gio::DBus::Object::get_interface ( const Glib::ustring & interface_name) const

Gets the D-Bus interface with name interface_name associated with object, if any.

Since glibmm 2.30
Parameters
interface_nameA D-Bus interface name.
Returns
nullptr if not found, otherwise a DBusInterface that must be freed with Glib::object_unref().

◆ get_interface_vfunc()

virtual Glib::RefPtr< Gio::DBus::Interface > Gio::DBus::Object::get_interface_vfunc ( const Glib::ustring & interface_name) const
protectedvirtual

◆ get_interfaces() [1/2]

std::vector< Glib::RefPtr< Gio::DBus::Interface > > Gio::DBus::Object::get_interfaces ( )

Gets the D-Bus interfaces associated with object.

Since glibmm 2.30
Returns
A list of DBusInterface instances.

◆ get_interfaces() [2/2]

std::vector< Glib::RefPtr< const Gio::DBus::Interface > > Gio::DBus::Object::get_interfaces ( ) const

Gets the D-Bus interfaces associated with object.

Since glibmm 2.30
Returns
A list of DBusInterface instances.

◆ get_interfaces_vfunc()

virtual std::vector< Glib::RefPtr< Gio::DBus::Interface > > Gio::DBus::Object::get_interfaces_vfunc ( ) const
protectedvirtual

◆ get_object_path()

Glib::ustring Gio::DBus::Object::get_object_path ( ) const

Gets the object path for object.

Since glibmm 2.30
Returns
A string owned by object. Do not free.

◆ get_object_path_vfunc()

virtual Glib::ustring Gio::DBus::Object::get_object_path_vfunc ( ) const
protectedvirtual

◆ get_type()

static GType Gio::DBus::Object::get_type ( )
static

Get the GType for this class, for use with the underlying GObject type system.

◆ gobj() [1/2]

GDBusObject * Gio::DBus::Object::gobj ( )
inline

Provides access to the underlying C GObject.

◆ gobj() [2/2]

const GDBusObject * Gio::DBus::Object::gobj ( ) const
inline

Provides access to the underlying C GObject.

◆ on_interface_added()

virtual void Gio::DBus::Object::on_interface_added ( const Glib::RefPtr< Gio::DBus::Interface > & iface)
protectedvirtual

This is a default handler for the signal signal_interface_added().

◆ on_interface_removed()

virtual void Gio::DBus::Object::on_interface_removed ( const Glib::RefPtr< Gio::DBus::Interface > & iface)
protectedvirtual

This is a default handler for the signal signal_interface_removed().

◆ operator=()

Object & Gio::DBus::Object::operator= ( Object && src)
noexcept

Friends And Related Symbol Documentation

◆ wrap()

Glib::RefPtr< Gio::DBus::Object > wrap ( GDBusObject * object,
bool take_copy = false )
related

A Glib::wrap() method for this object.

Parameters
objectThe C instance.
take_copyFalse if the result should take ownership of the C instance. True if it should take a new copy or ref.
Returns
A C++ instance that wraps this C instance.

Member Data Documentation

◆ signal_interface_added

Glib::SignalProxy< void(const Glib::RefPtr< Gio::DBus::Interface > &) Gio::DBus::Object::signal_interface_added) ()
Slot Prototype:
void on_my_interface_added(const Glib::RefPtr<Gio::DBus::Interface>& iface)

Flags: Run Last

Emitted when iface is added to object.

Since glibmm 2.30
Parameters
ifaceThe DBusInterface that was added.

◆ signal_interface_removed

Glib::SignalProxy< void(const Glib::RefPtr< Gio::DBus::Interface > &) Gio::DBus::Object::signal_interface_removed) ()
Slot Prototype:
void on_my_interface_removed(const Glib::RefPtr<Gio::DBus::Interface>& iface)

Flags: Run Last

Emitted when iface is removed from object.

Since glibmm 2.30
Parameters
ifaceThe DBusInterface that was removed.