#include <TelepathyQt4/Client/Connection>
Public Slots | |
QDBusPendingReply< QStringList, ushort, ushort, ushort, ushort, uint > | GetAvatarRequirements () |
QDBusPendingReply< QStringList > | GetAvatarTokens (const Telepathy::UIntList &contacts) |
QDBusPendingReply < Telepathy::AvatarTokenMap > | GetKnownAvatarTokens (const Telepathy::UIntList &contacts) |
QDBusPendingReply< QByteArray, QString > | RequestAvatar (uint contact) |
QDBusPendingReply | RequestAvatars (const Telepathy::UIntList &contacts) |
QDBusPendingReply< QString > | SetAvatar (const QByteArray &avatar, const QString &MIMEType) |
QDBusPendingReply | ClearAvatar () |
Signals | |
void | AvatarUpdated (uint contact, const QString &newAvatarToken) |
void | AvatarRetrieved (uint contact, const QString &token, const QByteArray &avatar, const QString &type) |
Public Member Functions | |
ConnectionInterfaceAvatarsInterface (const QString &serviceName, const QString &objectPath, QObject *parent=0) | |
ConnectionInterfaceAvatarsInterface (const QDBusConnection &connection, const QString &serviceName, const QString &objectPath, QObject *parent=0) | |
ConnectionInterfaceAvatarsInterface (Telepathy::Client::DBusProxy *proxy) | |
ConnectionInterfaceAvatarsInterface (const Telepathy::Client::ConnectionInterface &mainInterface) | |
ConnectionInterfaceAvatarsInterface (const Telepathy::Client::ConnectionInterface &mainInterface, QObject *parent) | |
Static Public Member Functions | |
static const char * | staticInterfaceName () |
Protected Member Functions | |
virtual void | invalidate (Telepathy::Client::DBusProxy *, const QString &, const QString &) |
Telepathy::Client::ConnectionInterfaceAvatarsInterface::ConnectionInterfaceAvatarsInterface | ( | const QString & | serviceName, | |
const QString & | objectPath, | |||
QObject * | parent = 0 | |||
) |
Creates a ConnectionInterfaceAvatarsInterface associated with the given object on the session bus.
serviceName | Name of the service the object is on. | |
objectPath | Path to the object on the service. | |
parent | Passed to the parent class constructor. |
Telepathy::Client::ConnectionInterfaceAvatarsInterface::ConnectionInterfaceAvatarsInterface | ( | const QDBusConnection & | connection, | |
const QString & | serviceName, | |||
const QString & | objectPath, | |||
QObject * | parent = 0 | |||
) |
Creates a ConnectionInterfaceAvatarsInterface associated with the given object on the given bus.
connection | The bus via which the object can be reached. | |
serviceName | Name of the service the object is on. | |
objectPath | Path to the object on the service. | |
parent | Passed to the parent class constructor. |
Telepathy::Client::ConnectionInterfaceAvatarsInterface::ConnectionInterfaceAvatarsInterface | ( | Telepathy::Client::DBusProxy * | proxy | ) |
Creates a ConnectionInterfaceAvatarsInterface associated with the same object as the given proxy.
proxy | The proxy to use. It will also be the QObject::parent() for this object. |
Telepathy::Client::ConnectionInterfaceAvatarsInterface::ConnectionInterfaceAvatarsInterface | ( | const Telepathy::Client::ConnectionInterface & | mainInterface | ) | [explicit] |
Creates a ConnectionInterfaceAvatarsInterface associated with the same object as the given proxy. Additionally, the created proxy will have the same parent as the given proxy.
mainInterface | The proxy to use. |
Telepathy::Client::ConnectionInterfaceAvatarsInterface::ConnectionInterfaceAvatarsInterface | ( | const Telepathy::Client::ConnectionInterface & | mainInterface, | |
QObject * | parent | |||
) |
Creates a ConnectionInterfaceAvatarsInterface associated with the same object as the given proxy. However, a different parent object can be specified.
mainInterface | The proxy to use. | |
parent | Passed to the parent class constructor. |
void Telepathy::Client::ConnectionInterfaceAvatarsInterface::AvatarRetrieved | ( | uint | contact, | |
const QString & | token, | |||
const QByteArray & | avatar, | |||
const QString & | type | |||
) | [signal] |
Represents the signal "AvatarRetrieved" on the remote object.
Emitted when the avatar for a contact has been retrieved.
contact | The contact whose avatar has been retrieved | |
token | The token corresponding to the avatar | |
avatar | An array of bytes containing the image data | |
type | A string containing the image MIME type (eg image/jpeg), or empty if unknown |
void Telepathy::Client::ConnectionInterfaceAvatarsInterface::AvatarUpdated | ( | uint | contact, | |
const QString & | newAvatarToken | |||
) | [signal] |
Represents the signal "AvatarUpdated" on the remote object.
Emitted when the avatar for a contact has been updated, or first discovered on this connection. If the token differs from the token associated with the client's cached avatar for this contact, the new avatar should be requested with RequestAvatars.
contact | An integer handle for the contact whose avatar has changed | |
newAvatarToken | Unique token for their new avatar |
QDBusPendingReply Telepathy::Client::ConnectionInterfaceAvatarsInterface::ClearAvatar | ( | ) | [inline, slot] |
Begins a call to the D-Bus method "ClearAvatar" on the remote object.
Remove the avatar image for this connection.
References Telepathy::Client::AbstractInterface::invalidationMessage(), and Telepathy::Client::AbstractInterface::invalidationReason().
QDBusPendingReply<QStringList, ushort, ushort, ushort, ushort, uint> Telepathy::Client::ConnectionInterfaceAvatarsInterface::GetAvatarRequirements | ( | ) | [inline, slot] |
Begins a call to the D-Bus method "GetAvatarRequirements" on the remote object.
Get the required format of avatars on this connection.
References Telepathy::Client::AbstractInterface::invalidationMessage(), and Telepathy::Client::AbstractInterface::invalidationReason().
QDBusPendingReply<QStringList> Telepathy::Client::ConnectionInterfaceAvatarsInterface::GetAvatarTokens | ( | const Telepathy::UIntList & | contacts | ) | [inline, slot] |
Begins a call to the D-Bus method "GetAvatarTokens" on the remote object.
Get the unique tokens for all of the given contacts' avatars. Using this method in new Telepathy clients is deprecated; use GetKnownAvatarTokens instead.
contacts | An array of handles representing contacts |
References Telepathy::Client::AbstractInterface::invalidationMessage(), and Telepathy::Client::AbstractInterface::invalidationReason().
QDBusPendingReply<Telepathy::AvatarTokenMap> Telepathy::Client::ConnectionInterfaceAvatarsInterface::GetKnownAvatarTokens | ( | const Telepathy::UIntList & | contacts | ) | [inline, slot] |
Begins a call to the D-Bus method "GetKnownAvatarTokens" on the remote object.
Get the unique tokens for the given contacts' avatars. These tokens can be persisted across connections, and should be used by the client to check whether the avatars have been updated. For handles other than the self handle, only tokens that are already known are returned; an empty token means the given contact has no avatar. However, a CM must always have the tokens for the self handle if one is set (even if it is set to no avatar). On protocols where the avatar does not persist between connections, a CM should omit the self handle from the returned map until an avatar is explicitly set or cleared.
contacts | An array of handles representing contacts |
References Telepathy::Client::AbstractInterface::invalidationMessage(), and Telepathy::Client::AbstractInterface::invalidationReason().
virtual void Telepathy::Client::ConnectionInterfaceAvatarsInterface::invalidate | ( | Telepathy::Client::DBusProxy * | , | |
const QString & | , | |||
const QString & | ||||
) | [protected, virtual] |
Reimplemented from Telepathy::Client::AbstractInterface.
QDBusPendingReply<QByteArray, QString> Telepathy::Client::ConnectionInterfaceAvatarsInterface::RequestAvatar | ( | uint | contact | ) | [inline, slot] |
Begins a call to the D-Bus method "RequestAvatar" on the remote object.
Request the avatar for a given contact. Using this method in new Telepathy clients is deprecated; use RequestAvatars instead.
contact | An integer handle for the contact to request the avatar for |
References Telepathy::Client::AbstractInterface::invalidationMessage(), and Telepathy::Client::AbstractInterface::invalidationReason().
QDBusPendingReply Telepathy::Client::ConnectionInterfaceAvatarsInterface::RequestAvatars | ( | const Telepathy::UIntList & | contacts | ) | [inline, slot] |
Begins a call to the D-Bus method "RequestAvatars" on the remote object.
Request avatars for a number of contacts. The AvatarRetrieved signal is emitted for each avatar retrieved. If the handles are valid but retrieving an avatar fails (for any reason, including the contact not having an avatar) the AvatarRetrieved signal is not emitted for that contact.
contacts | The contacts to retrieve avatars for |
References Telepathy::Client::AbstractInterface::invalidationMessage(), and Telepathy::Client::AbstractInterface::invalidationReason().
QDBusPendingReply<QString> Telepathy::Client::ConnectionInterfaceAvatarsInterface::SetAvatar | ( | const QByteArray & | avatar, | |
const QString & | MIMEType | |||
) | [inline, slot] |
Begins a call to the D-Bus method "SetAvatar" on the remote object.
Set a new avatar image for this connection. The avatar image must respect the requirements obtained by GetAvatarRequirements.
avatar | An array of bytes representing the avatar image data | |
MIMEType | A string representing the image MIME type |
References Telepathy::Client::AbstractInterface::invalidationMessage(), and Telepathy::Client::AbstractInterface::invalidationReason().
static const char* Telepathy::Client::ConnectionInterfaceAvatarsInterface::staticInterfaceName | ( | ) | [inline, static] |
Returns the name of the interface "org.freedesktop.Telepathy.Connection.Interface.Avatars", which this class represents.