Back to Seed Clases







parent-child marker Gio.DBusProxy

Class Gio.DBusProxy

Import line: Gio =;
GIR File: Gio-2.0.gir
C documentation: GDBusProxy
Class : DBusProxy
Implements: Gio.AsyncInitable, Gio.Initable
Extends: GObject.Object
GDBusProxy is a base class used for proxies to access a D-Bus
interface on a remote object. A GDBusProxy can be constructed for
both well-known and unique names.
By default, GDBusProxy will cache all properties (and listen to
changes) of the remote object, and proxy all signals that gets
emitted. This behaviour can be changed by passing suitable
GDBusProxyFlags when the proxy is created. If the proxy is for a
well-known name, the property cache is flushed when the name owner
vanishes and reloaded when a name owner appears.
If a GDBusProxy is used for a well-known name, the owner of the
name is tracked and can be read from
GDBusProxy:g-name-owner. Connect to the GObject::notify signal to
get notified of changes. Additionally, only signals and property
changes emitted from the current name owner are considered and
calls are always sent to the current name owner. This avoids a
number of race conditions when the name is lost by one owner and
claimed by another. However, if no name owner currently exists,
then calls will be sent to the well-known name which may result in
the message bus launching an owner (unless
The generic GDBusProxy::g-properties-changed and GDBusProxy::g-signal
signals are not very convenient to work with. Therefore, the recommended
way of working with proxies is to subclass GDBusProxy, and have
more natural properties and signals in your derived class.
See for an example.
GDBusProxy for a well-known-nameFIXME: MISSING XINCLUDE CONTENT
Properties Defined By
Methods / Constructors
Method / Constructor Defined By
Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event Defined By
Used by These Methods / Signals / Properties- Nowhere other than here
Documentation generated by Introspection Doc Generator Loosely Based on JsDoc Toolkit on Sat Apr 16 2011 17:11:10 GMT+0800 (HKT)