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 GDBusObjectManager type is the base type for service- and client-side implementations of the standardized org.freedesktop.DBus.ObjectManager interface.

See [class`Gio`.DBusObjectManagerClient] for the client-side implementation and [class`Gio`.DBusObjectManagerServer] for the service-side implementation.

get_interface(object_path, interface_name)

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 or None

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

New in version 2.30.

get_object(object_path)

Parameters:

object_path (str) – Object path to look up.

Returns:

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

Return type:

Gio.DBusObject or None

Gets the Gio.DBusObject at object_path, if any.

New in version 2.30.

get_object_path()

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()

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 or None

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 or None

Gets the Gio.DBusObject 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:

• object (Gio.DBusObject) –

• interface (Gio.DBusInterface) –

Signal handler for the Gio.DBusObjectManager ::interface-added signal.

do_interface_removed(object, interface_) virtual

Parameters:

• object (Gio.DBusObject) –

• interface (Gio.DBusInterface) –

Signal handler for the Gio.DBusObjectManager ::interface-removed signal.

do_object_added(object) virtual

Parameters:

object (Gio.DBusObject) –

Signal handler for the Gio.DBusObjectManager ::object-added signal.

do_object_removed(object) virtual

Parameters:

object (Gio.DBusObject) –

Signal handler for the Gio.DBusObjectManager ::object-removed signal.

Signal Details

Gio.DBusObjectManager.signals.interface_added(d_bus_object_manager, object, interface)

Signal Name:

interface-added

Flags:

RUN_LAST

Parameters:

• d_bus_object_manager (Gio.DBusObjectManager) – The object which received the signal

• object (Gio.DBusObject) – The Gio.DBusObject on which an interface was added.

• interface (Gio.DBusInterface) – The Gio.DBusInterface that was 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.

New in version 2.30.

Gio.DBusObjectManager.signals.interface_removed(d_bus_object_manager, object, interface)

Signal Name:

interface-removed

Flags:

RUN_LAST

Parameters:

• d_bus_object_manager (Gio.DBusObjectManager) – The object which received the signal

• object (Gio.DBusObject) – The Gio.DBusObject on which an interface was removed.

• interface (Gio.DBusInterface) – The Gio.DBusInterface that was 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.

New in version 2.30.

Gio.DBusObjectManager.signals.object_added(d_bus_object_manager, object)

Signal Name:

object-added

Flags:

RUN_LAST

Parameters:

• d_bus_object_manager (Gio.DBusObjectManager) – The object which received the signal

• object (Gio.DBusObject) – The Gio.DBusObject that was added.

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:

• d_bus_object_manager (Gio.DBusObjectManager) – The object which received the signal

• object (Gio.DBusObject) – The Gio.DBusObject that was removed.

Emitted when object is removed from manager.

New in version 2.30.