#include <TelepathyQt4/Client/ConnectionManager>
Classes | |
struct | Private |
Public Types | |
enum | Feature { FeatureCore = 0, _Padding = 0xFFFFFFFF } |
Public Member Functions | |
ConnectionManager (const QString &name, QObject *parent=0) | |
ConnectionManager (const QDBusConnection &bus, const QString &name, QObject *parent=0) | |
virtual | ~ConnectionManager () |
QString | name () const |
QStringList | interfaces () const |
QStringList | supportedProtocols () const |
const ProtocolInfoList & | protocols () const |
PendingConnection * | requestConnection (const QString &protocol, const QVariantMap ¶meters) |
DBus::PropertiesInterface * | propertiesInterface () const |
bool | isReady (const QSet< uint > &features=QSet< uint >()) const |
PendingReady * | becomeReady (const QSet< uint > &requestedFeatures=QSet< uint >()) |
QSet< uint > | requestedFeatures () const |
QSet< uint > | actualFeatures () const |
QSet< uint > | missingFeatures () const |
Static Public Member Functions | |
static PendingStringList * | listNames (const QDBusConnection &bus=QDBusConnection::sessionBus()) |
Protected Member Functions | |
ConnectionManagerInterface * | baseInterface () const |
Friends | |
struct | Private |
class | PendingConnection |
Most client applications should use this functionality via the AccountManager, to allow connections to be shared between client applications.
Telepathy::Client::ConnectionManager::ConnectionManager | ( | const QString & | name, | |
QObject * | parent = 0 | |||
) |
Construct a new ConnectionManager object.
name | Name of the connection manager. | |
parent | Object parent. |
Telepathy::Client::ConnectionManager::ConnectionManager | ( | const QDBusConnection & | bus, | |
const QString & | name, | |||
QObject * | parent = 0 | |||
) |
Construct a new ConnectionManager object.
bus | QDBusConnection to use. | |
name | Name of the connection manager. | |
parent | Object parent. |
Telepathy::Client::ConnectionManager::~ConnectionManager | ( | ) | [virtual] |
Class destructor.
QSet< uint > Telepathy::Client::ConnectionManager::actualFeatures | ( | ) | const |
ConnectionManagerInterface * Telepathy::Client::ConnectionManager::baseInterface | ( | ) | const [protected] |
Get the ConnectionManagerInterface for this ConnectionManager. This method is protected since the convenience methods provided by this class should generally be used instead of calling D-Bus methods directly.
References Telepathy::Client::ConnectionManager::ConnectionManager::Private::baseInterface.
PendingReady * Telepathy::Client::ConnectionManager::becomeReady | ( | const QSet< uint > & | requestedFeatures = QSet<uint>() |
) |
Return a pending operation which will succeed when this object finishes its initial setup, or will fail if a fatal error occurs during this initial setup.
If an empty set is used FeatureCore will be considered as the requested feature.
requestedFeatures | The features which should be enabled |
References Telepathy::Client::ReadinessHelper::becomeReady(), and Telepathy::Client::ConnectionManager::ConnectionManager::Private::readinessHelper.
QStringList Telepathy::Client::ConnectionManager::interfaces | ( | ) | const |
bool Telepathy::Client::ConnectionManager::isReady | ( | const QSet< uint > & | features = QSet<uint>() |
) | const |
Return whether this object has finished its initial setup.
This is mostly useful as a sanity check, in code that shouldn't be run until the object is ready. To wait for the object to be ready, call becomeReady() and connect to the finished signal on the result.
features | The features which should be tested |
true
if the object has finished initial setup. References Telepathy::Client::ReadinessHelper::isReady(), and Telepathy::Client::ConnectionManager::ConnectionManager::Private::readinessHelper.
PendingStringList * Telepathy::Client::ConnectionManager::listNames | ( | const QDBusConnection & | bus = QDBusConnection::sessionBus() |
) | [static] |
Return a pending operation from which a list of all installed connection manager short names (such as "gabble" or "haze") can be retrieved if it succeeds.
QSet< uint > Telepathy::Client::ConnectionManager::missingFeatures | ( | ) | const |
QString Telepathy::Client::ConnectionManager::name | ( | ) | const |
Get the short name of the connection manager (e.g. "gabble").
References Telepathy::Client::ConnectionManager::ConnectionManager::Private::name.
DBus::propertiesInterface * Telepathy::Client::ConnectionManager::propertiesInterface | ( | ) | const [inline] |
Convenience function for getting a Properties interface proxy. The Properties interface is not necessarily reported by the services, so a check
parameter is not provided, and the interface is always assumed to be present.
const ProtocolInfoList & Telepathy::Client::ConnectionManager::protocols | ( | ) | const |
Get a list of protocols info for this connection manager.
References Telepathy::Client::ConnectionManager::ConnectionManager::Private::protocols.
Referenced by supportedProtocols().
PendingConnection * Telepathy::Client::ConnectionManager::requestConnection | ( | const QString & | protocol, | |
const QVariantMap & | parameters | |||
) |
Request a Connection object representing a given account on a given protocol with the given parameters.
Return a pending operation representing the Connection object which will succeed when the connection has been created or fail if an error occurred.
protocol | Name of the protocol to create the account for. | |
parameters | Account parameters. |
References PendingConnection.
QSet< uint > Telepathy::Client::ConnectionManager::requestedFeatures | ( | ) | const |
QStringList Telepathy::Client::ConnectionManager::supportedProtocols | ( | ) | const |
Get a list of strings identifying the protocols supported by this connection manager, as described in the Telepathy D-Bus API Specification (e.g. "jabber").
These identifiers are not intended to be displayed to users directly; user interfaces are responsible for mapping them to localized strings.
References Telepathy::Client::ProtocolInfo::name(), Telepathy::Client::ConnectionManager::ConnectionManager::Private::protocols, and protocols().
friend class PendingConnection [friend] |
Referenced by requestConnection().
friend struct Private [friend] |
Reimplemented from Telepathy::Client::StatelessDBusProxy.