Home · All Classes · All Namespaces · Modules · Functions · Files
Signals | Public Member Functions | Protected Member Functions | List of all members
Tp::DBusProxy Class Reference

The DBusProxy class is a base class representing a remote object available over D-Bus. More...

#include <TelepathyQt/DBusProxy>

Inheritance diagram for Tp::DBusProxy:
Inheritance graph
[legend]

Signals

void invalidated (Tp::DBusProxy *proxy, const QString &errorName, const QString &errorMessage)
 
- Signals inherited from Tp::Object
void propertyChanged (const QString &propertyName)
 

Public Member Functions

 DBusProxy (const QDBusConnection &dbusConnection, const QString &busName, const QString &objectPath, const Feature &featureCore)
 
virtual ~DBusProxy ()
 
QDBusConnection dbusConnection () const
 
QString busName () const
 
QString objectPath () const
 
bool isValid () const
 
QString invalidationReason () const
 
QString invalidationMessage () const
 
- Public Member Functions inherited from Tp::Object
virtual ~Object ()
 
- Public Member Functions inherited from QObject
 QObject (QObject *parent)
 
virtual  ~QObject ()
 
virtual bool event (QEvent *e)
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
virtual const QMetaObjectmetaObject () const
 
QString objectName () const
 
void setObjectName (const QString &name)
 
bool isWidgetType () const
 
bool signalsBlocked () const
 
bool blockSignals (bool block)
 
QThreadthread () const
 
void moveToThread (QThread *targetThread)
 
int startTimer (int interval)
 
void killTimer (int id)
 
findChild (const QString &name) const
 
QList< T > findChildren (const QString &name) const
 
QList< T > findChildren (const QRegExp &regExp) const
 
QObjectchild (const char *objName, const char *inheritsClass, bool recursiveSearch) const
 
const QObjectList & children () const
 
void setParent (QObject *parent)
 
void installEventFilter (QObject *filterObj)
 
void removeEventFilter (QObject *obj)
 
bool connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const
 
bool disconnect (const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *receiver, const char *method)
 
void dumpObjectTree ()
 
void dumpObjectInfo ()
 
bool setProperty (const char *name, const QVariant &value)
 
QVariant property (const char *name) const
 
QList< QByteArraydynamicPropertyNames () const
 
void destroyed (QObject *obj)
 
QObjectparent () const
 
bool inherits (const char *className) const
 
void deleteLater ()
 
 QObject (QObject *parent, const char *name)
 
void insertChild (QObject *object)
 
void removeChild (QObject *object)
 
bool isA (const char *className) const
 
const char * className () const
 
const char * name () const
 
const char * name (const char *defaultName) const
 
void setName (const char *name)
 
- Public Member Functions inherited from Tp::RefCounted
 RefCounted ()
 
virtual ~RefCounted ()
 
- Public Member Functions inherited from Tp::ReadyObject
 ReadyObject (RefCounted *object, const Feature &featureCore)
 
 ReadyObject (DBusProxy *proxy, const Feature &featureCore)
 
virtual ~ReadyObject ()
 
virtual bool isReady (const Features &features=Features()) const
 
virtual PendingReadybecomeReady (const Features &requestedFeatures=Features())
 
virtual Features requestedFeatures () const
 
virtual Features actualFeatures () const
 
virtual Features missingFeatures () const
 

Protected Member Functions

void setBusName (const QString &busName)
 
void invalidate (const QString &reason, const QString &message)
 
void invalidate (const QDBusError &error)
 
- Protected Member Functions inherited from Tp::Object
 Object ()
 
void notify (const char *propertyName)
 
- Protected Member Functions inherited from QObject
QObjectsender () const
 
int senderSignalIndex () const
 
int receivers (const char *signal) const
 
virtual void timerEvent (QTimerEvent *event)
 
virtual void childEvent (QChildEvent *event)
 
virtual void customEvent (QEvent *event)
 
virtual void connectNotify (const char *signal)
 
virtual void disconnectNotify (const char *signal)
 
bool checkConnectArgs (const char *signal, const QObject *object, const char *method)
 
- Protected Member Functions inherited from Tp::ReadyObject
ReadinessHelperreadinessHelper () const
 

Additional Inherited Members

- Static Public Member Functions inherited from QObject
QString tr (const char *sourceText, const char *disambiguation, int n)
 
QString trUtf8 (const char *sourceText, const char *disambiguation, int n)
 
bool connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
 
bool connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
 
bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *method)
 
bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method)
 
- Static Protected Member Functions inherited from QObject
QByteArray normalizeSignalSlot (const char *signalSlot)
 
- Properties inherited from QObject
 objectName
 

Detailed Description

The DBusProxy class is a base class representing a remote object available over D-Bus.

All Telepathy-Qt client convenience classes that wrap Telepathy interfaces inherit from this class in order to provide basic D-Bus interface information.

Constructor & Destructor Documentation

Tp::DBusProxy::DBusProxy ( const QDBusConnection dbusConnection,
const QString busName,
const QString objectPath,
const Feature featureCore 
)

Construct a new DBusProxy object.

Parameters
dbusConnectionQDBusConnection to use.
busNameD-Bus bus name of the service that provides the remote object.
objectPathThe object path.
featureCoreThe object core feature.
Tp::DBusProxy::~DBusProxy ( )
virtual

Class destructor.

Member Function Documentation

QDBusConnection Tp::DBusProxy::dbusConnection ( ) const

Return the D-Bus connection through which the remote object is accessed.

Returns
A QDBusConnection object.
QString Tp::DBusProxy::busName ( ) const

Return the D-Bus bus name (either a unique name or a well-known name) of the service that provides the remote object.

Returns
The D-Bus bus name.
QString Tp::DBusProxy::objectPath ( ) const

Return the D-Bus object path of the remote object within the service.

Returns
The D-Bus object path.
bool Tp::DBusProxy::isValid ( ) const

Return whether this proxy is still valid (has not emitted invalidated()).

Returns
true if still valid, false otherwise.
QString Tp::DBusProxy::invalidationReason ( ) const

Return the error name indicating the reason this proxy became invalid.

Returns
A D-Bus error name, or QString() if this object is still valid.
QString Tp::DBusProxy::invalidationMessage ( ) const

Return a debugging message indicating the reason this proxy became invalid.

Returns
A debugging message, or QString() if this object is still valid.
void Tp::DBusProxy::invalidated ( Tp::DBusProxy proxy,
const QString errorName,
const QString errorMessage 
)
signal

Emitted when this object is no longer usable.

After this signal is emitted, any D-Bus method calls on the object will fail, but it may be possible to retrieve information that has already been retrieved and cached.

Parameters
proxyThis proxy.
errorNameThe name of a D-Bus error describing the reason for the invalidation.
errorMessageA debugging message associated with the error.
void Tp::DBusProxy::setBusName ( const QString busName)
protected

Sets the D-Bus bus name. This is used by subclasses after converting well-known names to unique names.

Parameters
busNameThe D-Bus bus name to set.
void Tp::DBusProxy::invalidate ( const QString reason,
const QString message 
)
protected

Called by subclasses when the DBusProxy should become invalid.

This method takes care of setting the invalidationReason, invalidationMessage, and emitting the invalidated signal.

Parameters
reasonA D-Bus error name (a string in a subset of ASCII, prefixed with a reversed domain name)
messageA debugging message associated with the error
void Tp::DBusProxy::invalidate ( const QDBusError error)
protected


Copyright © 2008-2011 Collabora Ltd. and Nokia Corporation
Telepathy-Qt 0.9.4