Gio.DBusObjectManager

g GObject.GInterface GObject.GInterface Gio.DBusObjectManager Gio.DBusObjectManager GObject.GInterface->Gio.DBusObjectManager

Implementations:
 Gio.DBusObjectManagerClient, Gio.DBusObjectManagerServer

Methods

  get_interface (object_path, interface_name)
  get_object (object_path)
  get_object_path ()
  get_objects ()

Virtual Methods

  do_get_interface (object_path, interface_name)
  do_get_object (object_path)
  do_get_object_path ()
  do_get_objects ()
  do_interface_added (object, interface_)
  do_interface_removed (object, interface_)
  do_object_added (object)
  do_object_removed (object)

Properties

None

Signals

Name Short Description
interface-added Emitted when interface is added to object.
interface-removed Emitted when interface has been removed from object.
object-added Emitted when object is added to manager.
object-removed Emitted when object is removed from manager.

Fields

None

Class Details

class Gio.DBusObjectManager
Bases:GObject.GInterface
Structure:Gio.DBusObjectManagerIface

The Gio.DBusObjectManager type is the base type for service- and client-side implementations of the standardized org.freedesktop.DBus.ObjectManager interface.

See Gio.DBusObjectManagerClient for the client-side implementation and Gio.DBusObjectManagerServer for the service-side implementation.

get_interface(object_path, interface_name)[source]
Parameters:
  • object_path (str) – Object path to look up.
  • interface_name (str) – D-Bus interface name to look up.
Returns:

A Gio.DBusInterface instance or None. Free with GObject.Object.unref().

Return type:

Gio.DBusInterface

Gets the interface proxy for interface_name at object_path, if any.

New in version 2.30.

get_object(object_path)[source]
Parameters:object_path (str) – Object path to look up.
Returns:A Gio.DBusObject or None. Free with GObject.Object.unref().
Return type:Gio.DBusObject

Gets the Gio.DBusObjectProxy at object_path, if any.

New in version 2.30.

get_object_path()[source]
Returns:A string owned by self. Do not free.
Return type:str

Gets the object path that self is for.

New in version 2.30.

get_objects()[source]
Returns:A list of Gio.DBusObject objects. The returned list should be freed with g_list_free() after each element has been freed with GObject.Object.unref().
Return type:[Gio.DBusObject]

Gets all Gio.DBusObject objects known to self.

New in version 2.30.

do_get_interface(object_path, interface_name) virtual
Parameters:
  • object_path (str) – Object path to look up.
  • interface_name (str) – D-Bus interface name to look up.
Returns:

A Gio.DBusInterface instance or None. Free with GObject.Object.unref().

Return type:

Gio.DBusInterface

Gets the interface proxy for interface_name at object_path, if any.

New in version 2.30.

do_get_object(object_path) virtual
Parameters:object_path (str) – Object path to look up.
Returns:A Gio.DBusObject or None. Free with GObject.Object.unref().
Return type:Gio.DBusObject

Gets the Gio.DBusObjectProxy at object_path, if any.

New in version 2.30.

do_get_object_path() virtual
Returns:A string owned by manager. Do not free.
Return type:str

Gets the object path that manager is for.

New in version 2.30.

do_get_objects() virtual
Returns:A list of Gio.DBusObject objects. The returned list should be freed with g_list_free() after each element has been freed with GObject.Object.unref().
Return type:[Gio.DBusObject]

Gets all Gio.DBusObject objects known to manager.

New in version 2.30.

do_interface_added(object, interface_) virtual
Parameters:
do_interface_removed(object, interface_) virtual
Parameters:
do_object_added(object) virtual
Parameters:object (Gio.DBusObject) –
do_object_removed(object) virtual
Parameters:object (Gio.DBusObject) –

Signal Details

Gio.DBusObjectManager.signals.interface_added(d_bus_object_manager, object, interface)
Signal Name:

interface-added

Flags:

RUN_LAST

Parameters:

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.

New in version 2.30.

Gio.DBusObjectManager.signals.interface_removed(d_bus_object_manager, object, interface)
Signal Name:

interface-removed

Flags:

RUN_LAST

Parameters:

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.

New in version 2.30.

Gio.DBusObjectManager.signals.object_added(d_bus_object_manager, object)
Signal Name:

object-added

Flags:

RUN_LAST

Parameters:

Emitted when object is added to manager.

New in version 2.30.

Gio.DBusObjectManager.signals.object_removed(d_bus_object_manager, object)
Signal Name:

object-removed

Flags:

RUN_LAST

Parameters:

Emitted when object is removed from manager.

New in version 2.30.