Home · All Classes · All Namespaces · Modules · Functions · Files
Public Slots | Signals | Public Member Functions | Static Public Member Functions | Protected Member Functions | Properties

Tp::Client::AccountInterface Class Reference
[Account proxies]

#include <TelepathyQt4/AccountManager>

Inherits Tp::AbstractInterface.

List of all members.

Public Slots

Signals

Public Member Functions

Static Public Member Functions

Protected Member Functions

Properties

Detailed Description

Proxy class providing a 1:1 mapping of the D-Bus interface "org.freedesktop.Telepathy.Account."

Constructor & Destructor Documentation

Tp::Client::AccountInterface::AccountInterface ( const QString &  busName,
const QString &  objectPath,
QObject *  parent = 0 
)

Creates a AccountInterface associated with the given object on the session bus.

Parameters:
busName Name of the service the object is on.
objectPath Path to the object on the service.
parent Passed to the parent class constructor.
Tp::Client::AccountInterface::AccountInterface ( const QDBusConnection &  connection,
const QString &  busName,
const QString &  objectPath,
QObject *  parent = 0 
)

Creates a AccountInterface associated with the given object on the given bus.

Parameters:
connection The bus via which the object can be reached.
busName Name of the service the object is on.
objectPath Path to the object on the service.
parent Passed to the parent class constructor.
Tp::Client::AccountInterface::AccountInterface ( Tp::DBusProxy *  proxy  ) 

Creates a AccountInterface associated with the same object as the given proxy.

Parameters:
proxy The proxy to use. It will also be the QObject::parent() for this object.

Member Function Documentation

static const char* Tp::Client::AccountInterface::staticInterfaceName (  )  [inline, static]

Returns the name of the interface "org.freedesktop.Telepathy.Account", which this class represents.

Returns:
The D-Bus interface name.
TELEPATHY_QT4_DEPRECATED QStringList Tp::Client::AccountInterface::Interfaces (  )  const [inline]

Getter for the remote object property "Interfaces".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyInterfaces() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyInterfaces (  )  const [inline]

Asynchronous getter for the remote object property "Interfaces" of type QStringList.

A list of the extra interfaces provided by this account.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED QString Tp::Client::AccountInterface::DisplayName (  )  const [inline]

Getter for the remote object property "DisplayName".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyDisplayName() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyDisplayName (  )  const [inline]

Asynchronous getter for the remote object property "DisplayName" of type QString.

The user-visible name of this account. This SHOULD be chosen by the user at account creation time. The account creation user interface is responsible for setting a reasonable default value in the user's locale; something like "Jabber (bob@example.com)" would be sensible. This approximately corresponds to "display name" in NMC 4.x and Decibel.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED void Tp::Client::AccountInterface::setDisplayName ( const QString &  newValue  )  [inline]

Setter for the remote object property "DisplayName".

Don't use this: it blocks the main loop.

Parameters:
newValue The value to set the property to.
Tp::PendingOperation* Tp::Client::AccountInterface::setPropertyDisplayName ( QString  newValue  )  [inline]

Asynchronous setter for the remote object property "DisplayName" of type QString.

The user-visible name of this account. This SHOULD be chosen by the user at account creation time. The account creation user interface is responsible for setting a reasonable default value in the user's locale; something like "Jabber (bob@example.com)" would be sensible. This approximately corresponds to "display name" in NMC 4.x and Decibel.

Returns:
A pending operation which will emit finished when the property has been set.
TELEPATHY_QT4_DEPRECATED QString Tp::Client::AccountInterface::Icon (  )  const [inline]

Getter for the remote object property "Icon".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyIcon() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyIcon (  )  const [inline]

Asynchronous getter for the remote object property "Icon" of type QString.

The name of an icon in the system's icon theme, such as "im-msn", or the empty string to not specify an icon. If the icon is set to an empty string, the account manager or any client MAY derive a default icon, for instance from the protocol. This approximately corresponds to mc_profile_get_icon_name (or possibly mc_profile_get_branding_icon_name) in NMC 4.x. It's accessed via the account rather than the profile because we no longer have profiles as a core concept.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED void Tp::Client::AccountInterface::setIcon ( const QString &  newValue  )  [inline]

Setter for the remote object property "Icon".

Don't use this: it blocks the main loop.

Parameters:
newValue The value to set the property to.
Tp::PendingOperation* Tp::Client::AccountInterface::setPropertyIcon ( QString  newValue  )  [inline]

Asynchronous setter for the remote object property "Icon" of type QString.

The name of an icon in the system's icon theme, such as "im-msn", or the empty string to not specify an icon. If the icon is set to an empty string, the account manager or any client MAY derive a default icon, for instance from the protocol. This approximately corresponds to mc_profile_get_icon_name (or possibly mc_profile_get_branding_icon_name) in NMC 4.x. It's accessed via the account rather than the profile because we no longer have profiles as a core concept.

Returns:
A pending operation which will emit finished when the property has been set.
TELEPATHY_QT4_DEPRECATED bool Tp::Client::AccountInterface::Valid (  )  const [inline]

Getter for the remote object property "Valid".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyValid() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyValid (  )  const [inline]

Asynchronous getter for the remote object property "Valid" of type bool.

If true, this account is considered by the account manager to be complete and usable. If false, user action is required to make it usable, and it will never attempt to connect (for instance, this might be caused by the absence of a required parameter). For connection managers with a plugin architecture, like telepathy-haze, we have little or no control over the parameters offered; for platforms with package management, we have little or no control over the CMs offered. NMC 4.x would just pretend the account didn't exist in these circumstances, but silent data loss is bad, and UIs with CM-specific knowledge (or a user filling in newly-required parameters) might be able to rescue a broken account.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED bool Tp::Client::AccountInterface::Enabled (  )  const [inline]

Getter for the remote object property "Enabled".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyEnabled() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyEnabled (  )  const [inline]

Asynchronous getter for the remote object property "Enabled" of type bool.

This property gives the users the possibility to prevent an account from being used. This flag does not change the validity of the account.

A disabled account can never be put online.

<tp:rationale>

Use cases:

  • user has two or more accounts capable of calling contact X, but he doesn't want the UI to prompt him everytime about which one he wants to use for the call. He can then disable all the equivalent accounts but one.

  • There is some temporary server error and the user doesn't want to be be bother by error messages, or change the account configuration: temporarily disabling the account is quicker.

</tp:rationale>

The AccountManager SHOULD allow this property to be set on invalid accounts, but MUST NOT attempt to put invalid accounts online even if they become Enabled.

<tp:rationale>

There doesn't seem to be any good reason not to allow this. </tp:rationale>

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED void Tp::Client::AccountInterface::setEnabled ( bool  newValue  )  [inline]

Setter for the remote object property "Enabled".

Don't use this: it blocks the main loop.

Parameters:
newValue The value to set the property to.
Tp::PendingOperation* Tp::Client::AccountInterface::setPropertyEnabled ( bool  newValue  )  [inline]

Asynchronous setter for the remote object property "Enabled" of type bool.

This property gives the users the possibility to prevent an account from being used. This flag does not change the validity of the account.

A disabled account can never be put online.

<tp:rationale>

Use cases:

  • user has two or more accounts capable of calling contact X, but he doesn't want the UI to prompt him everytime about which one he wants to use for the call. He can then disable all the equivalent accounts but one.

  • There is some temporary server error and the user doesn't want to be be bother by error messages, or change the account configuration: temporarily disabling the account is quicker.

</tp:rationale>

The AccountManager SHOULD allow this property to be set on invalid accounts, but MUST NOT attempt to put invalid accounts online even if they become Enabled.

<tp:rationale>

There doesn't seem to be any good reason not to allow this. </tp:rationale>

Returns:
A pending operation which will emit finished when the property has been set.
TELEPATHY_QT4_DEPRECATED QString Tp::Client::AccountInterface::Nickname (  )  const [inline]

Getter for the remote object property "Nickname".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyNickname() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyNickname (  )  const [inline]

Asynchronous getter for the remote object property "Nickname" of type QString.

The nickname to set on this account for display to other contacts, as set by the user. When the account becomes connected, the account manager SHOULD set this as the user's alias using SetAliases if appropriate. In a later specification revision, we plan to separate the concepts of a contact's nickname as set by themselves, and the local name for them in our contact list (a "handle" or "pet name" as described in XEP-0165 and its references). The terminology change from alias to nickname here is a step in that direction. This corresponds to NMC 4.x mc_account_get_alias.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED void Tp::Client::AccountInterface::setNickname ( const QString &  newValue  )  [inline]

Setter for the remote object property "Nickname".

Don't use this: it blocks the main loop.

Parameters:
newValue The value to set the property to.
Tp::PendingOperation* Tp::Client::AccountInterface::setPropertyNickname ( QString  newValue  )  [inline]

Asynchronous setter for the remote object property "Nickname" of type QString.

The nickname to set on this account for display to other contacts, as set by the user. When the account becomes connected, the account manager SHOULD set this as the user's alias using SetAliases if appropriate. In a later specification revision, we plan to separate the concepts of a contact's nickname as set by themselves, and the local name for them in our contact list (a "handle" or "pet name" as described in XEP-0165 and its references). The terminology change from alias to nickname here is a step in that direction. This corresponds to NMC 4.x mc_account_get_alias.

Returns:
A pending operation which will emit finished when the property has been set.
TELEPATHY_QT4_DEPRECATED QString Tp::Client::AccountInterface::Service (  )  const [inline]

Getter for the remote object property "Service".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyService() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyService (  )  const [inline]

Asynchronous getter for the remote object property "Service" of type QString.

Some protocols, like XMPP and SIP, are used by various different user-recognised brands, such as Google Talk and Ovi by Nokia. On accounts for such services, this property SHOULD be set to a string describing the service, which MUST consist only of ASCII letters, numbers and hyphen/minus signs, and start with a letter (matching the requirements for <tp:type>Protocol</tp:type>). For the jabber protocol, one of the following service names should be used if possible:

The <tp:member-ref>Icon</tp:member-ref> property SHOULD be set to a corresponding brand-specific icon name, if possible. In the future, this property may be used as an index into additional service-specific customizations. If this property is the empty string (or missing), the service is determined by the protocol name (either because this is a single-service protocol like msn, or because this is just a generic jabber or sip account without specific branding).

This property MAY be set, if appropriate, when calling <tp:dbus-ref namespace="org.freedesktop.Telepathy.AccountManager">CreateAccount</tp:dbus-ref>. Updating this property will fail on externally-stored accounts whose <tp:dbus-ref namespace="org.freedesktop.Telepathy.Account.Interface.Storage">StorageRestrictions</tp:dbus-ref> include Cannot_Set_Service.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED void Tp::Client::AccountInterface::setService ( const QString &  newValue  )  [inline]

Setter for the remote object property "Service".

Don't use this: it blocks the main loop.

Parameters:
newValue The value to set the property to.
Tp::PendingOperation* Tp::Client::AccountInterface::setPropertyService ( QString  newValue  )  [inline]

Asynchronous setter for the remote object property "Service" of type QString.

Some protocols, like XMPP and SIP, are used by various different user-recognised brands, such as Google Talk and Ovi by Nokia. On accounts for such services, this property SHOULD be set to a string describing the service, which MUST consist only of ASCII letters, numbers and hyphen/minus signs, and start with a letter (matching the requirements for <tp:type>Protocol</tp:type>). For the jabber protocol, one of the following service names should be used if possible:

The <tp:member-ref>Icon</tp:member-ref> property SHOULD be set to a corresponding brand-specific icon name, if possible. In the future, this property may be used as an index into additional service-specific customizations. If this property is the empty string (or missing), the service is determined by the protocol name (either because this is a single-service protocol like msn, or because this is just a generic jabber or sip account without specific branding).

This property MAY be set, if appropriate, when calling <tp:dbus-ref namespace="org.freedesktop.Telepathy.AccountManager">CreateAccount</tp:dbus-ref>. Updating this property will fail on externally-stored accounts whose <tp:dbus-ref namespace="org.freedesktop.Telepathy.Account.Interface.Storage">StorageRestrictions</tp:dbus-ref> include Cannot_Set_Service.

Returns:
A pending operation which will emit finished when the property has been set.
TELEPATHY_QT4_DEPRECATED QVariantMap Tp::Client::AccountInterface::Parameters (  )  const [inline]

Getter for the remote object property "Parameters".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyParameters() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyParameters (  )  const [inline]

Asynchronous getter for the remote object property "Parameters" of type QVariantMap.

A map from connection manager parameter names (as in the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ConnectionManager</tp:dbus-ref> interface) to their values. This property includes only those parameters that are stored for this account, and SHOULD only include those parameters that the user has explicitly set.

This property cannot be altered using Set() - use <tp:member-ref>UpdateParameters</tp:member-ref> instead.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED Tp::SimplePresence Tp::Client::AccountInterface::AutomaticPresence (  )  const [inline]

Getter for the remote object property "AutomaticPresence".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyAutomaticPresence() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyAutomaticPresence (  )  const [inline]

Asynchronous getter for the remote object property "AutomaticPresence" of type Tp::SimplePresence.

The presence status that this account should have if it is brought online.

<tp:rationale> In ITOS2007 and ITOS2008 this is a global preference, not visible on D-Bus (the "default presence"). "Automatic presence" better describes when it is used. </tp:rationale>

Setting this property MUST NOT actually change the account's status until the next time it is (re)connected for some reason.

The value of this property MUST be one that would be acceptable for <tp:member-ref>RequestedPresence</tp:member-ref>, with the additional restriction that the <tp:type>Connection_Presence_Type</tp:type> MUST NOT be Offline.

<tp:rationale>

Otherwise, it would not be possible to use this presence to bring the account online for a channel request. </tp:rationale>

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED void Tp::Client::AccountInterface::setAutomaticPresence ( const Tp::SimplePresence &  newValue  )  [inline]

Setter for the remote object property "AutomaticPresence".

Don't use this: it blocks the main loop.

Parameters:
newValue The value to set the property to.
Tp::PendingOperation* Tp::Client::AccountInterface::setPropertyAutomaticPresence ( Tp::SimplePresence  newValue  )  [inline]

Asynchronous setter for the remote object property "AutomaticPresence" of type Tp::SimplePresence.

The presence status that this account should have if it is brought online.

<tp:rationale> In ITOS2007 and ITOS2008 this is a global preference, not visible on D-Bus (the "default presence"). "Automatic presence" better describes when it is used. </tp:rationale>

Setting this property MUST NOT actually change the account's status until the next time it is (re)connected for some reason.

The value of this property MUST be one that would be acceptable for <tp:member-ref>RequestedPresence</tp:member-ref>, with the additional restriction that the <tp:type>Connection_Presence_Type</tp:type> MUST NOT be Offline.

<tp:rationale>

Otherwise, it would not be possible to use this presence to bring the account online for a channel request. </tp:rationale>

Returns:
A pending operation which will emit finished when the property has been set.
TELEPATHY_QT4_DEPRECATED bool Tp::Client::AccountInterface::ConnectAutomatically (  )  const [inline]

Getter for the remote object property "ConnectAutomatically".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyConnectAutomatically() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyConnectAutomatically (  )  const [inline]

Asynchronous getter for the remote object property "ConnectAutomatically" of type bool.

If true, the account manager SHOULD attempt to put this account online with the AutomaticPresence whenever possible (in the base Account interface this is deliberately left vague). If false, it MUST NOT put the account online automatically in response to, for instance, connectivity changes, but SHOULD still put the account online with the AutomaticPresence if requested by the user (for instance, if the user tries to start a conversation using this account). This approximately corresponds to NMC 4.x "enabled" and Decibel "autoreconnect".

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED void Tp::Client::AccountInterface::setConnectAutomatically ( bool  newValue  )  [inline]

Setter for the remote object property "ConnectAutomatically".

Don't use this: it blocks the main loop.

Parameters:
newValue The value to set the property to.
Tp::PendingOperation* Tp::Client::AccountInterface::setPropertyConnectAutomatically ( bool  newValue  )  [inline]

Asynchronous setter for the remote object property "ConnectAutomatically" of type bool.

If true, the account manager SHOULD attempt to put this account online with the AutomaticPresence whenever possible (in the base Account interface this is deliberately left vague). If false, it MUST NOT put the account online automatically in response to, for instance, connectivity changes, but SHOULD still put the account online with the AutomaticPresence if requested by the user (for instance, if the user tries to start a conversation using this account). This approximately corresponds to NMC 4.x "enabled" and Decibel "autoreconnect".

Returns:
A pending operation which will emit finished when the property has been set.
TELEPATHY_QT4_DEPRECATED QDBusObjectPath Tp::Client::AccountInterface::Connection (  )  const [inline]

Getter for the remote object property "Connection".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyConnection() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyConnection (  )  const [inline]

Asynchronous getter for the remote object property "Connection" of type QDBusObjectPath.

Either the object path of the <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection</tp:dbus-ref> to this account, or the special value '/' if there is no connection.

If this object path is not '/', the Connection's well-known bus name can be derived from this object path by removing the first '/' and replacing subsequent '/' characters with '.'.

<tp:rationale> Object paths aren't nullable, so we can't use an empty string. </tp:rationale>

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED uint Tp::Client::AccountInterface::ConnectionStatus (  )  const [inline]

Getter for the remote object property "ConnectionStatus".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyConnectionStatus() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyConnectionStatus (  )  const [inline]

Asynchronous getter for the remote object property "ConnectionStatus" of type uint.

If the Connection property is non-empty, the status of that connection. If the Connection property is the empty string, this property may either be Disconnected (indicating that the account manager is not attempting to bring it online), or Connecting (indicating that the account manager is attempting to connect). The account manager is expected to set this by observing signals from the Connection. If the AM is doing some sort of backoff/delay on reconnection attempts, the account's status is conceptually "Connecting" even though there is no Connection. This vaguely corresponds to GetCurrentStatus in NMC 4.x.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED uint Tp::Client::AccountInterface::ConnectionStatusReason (  )  const [inline]

Getter for the remote object property "ConnectionStatusReason".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyConnectionStatusReason() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyConnectionStatusReason (  )  const [inline]

Asynchronous getter for the remote object property "ConnectionStatusReason" of type uint.

The reason for the last change to ConnectionStatus. The account manager is expected to set this by observing signals from the Connection. If you weren't watching the Connection at the time it failed, you can't tell why - unless the AM can tell you. This is part of GetCurrentStatus in NMC 4.x.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED QString Tp::Client::AccountInterface::ConnectionError (  )  const [inline]

Getter for the remote object property "ConnectionError".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyConnectionError() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyConnectionError (  )  const [inline]

Asynchronous getter for the remote object property "ConnectionError" of type QString.

If the last connection to this account failed with an error, the D-Bus error name of that error; otherwise, the empty string. The account manager is expected to set this by observing the <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.ConnectionError</tp:dbus-ref> and <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.StatusChanged</tp:dbus-ref> signals.

If ConnectionError is received before the connection disconnects, its first argument should be used to set this property; otherwise, the Reason argument of StatusChanged should be converted to a suitable D-Bus error name.

Whenever the Connection connects successfully, this property should be reset to the empty string.

<tp:rationale>

This combines the state-recoverability of <tp:member-ref>ConnectionStatusReason</tp:member-ref> with the extensibility of Connection.ConnectionError. </tp:rationale>

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED QVariantMap Tp::Client::AccountInterface::ConnectionErrorDetails (  )  const [inline]

Getter for the remote object property "ConnectionErrorDetails".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyConnectionErrorDetails() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyConnectionErrorDetails (  )  const [inline]

Asynchronous getter for the remote object property "ConnectionErrorDetails" of type QVariantMap.

If the last connection to this account failed with an error, a mapping representing any additional information about the last disconnection; otherwise, the empty map. The keys and values are the same as for the second argument of <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.ConnectionError</tp:dbus-ref>.

Whenever the Connection connects successfully, this property should be reset to the empty map.

<tp:rationale>

This combines the state-recoverability of <tp:member-ref>ConnectionStatusReason</tp:member-ref> with the extensibility of Connection.ConnectionError. </tp:rationale>

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED Tp::SimplePresence Tp::Client::AccountInterface::CurrentPresence (  )  const [inline]

Getter for the remote object property "CurrentPresence".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyCurrentPresence() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyCurrentPresence (  )  const [inline]

Asynchronous getter for the remote object property "CurrentPresence" of type Tp::SimplePresence.

The actual presence. If the connection is not online, the Connection_Presence_Type SHOULD be Connection_Presence_Type_Offline. If the connection is online but does not support the SimplePresence interface, the type SHOULD be Connection_Presence_Type_Unset. The account manager is expected to set this by observing signals from the Connection. This corresponds to GetPresenceActual in NMC 4.x.

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED Tp::SimplePresence Tp::Client::AccountInterface::RequestedPresence (  )  const [inline]

Getter for the remote object property "RequestedPresence".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyRequestedPresence() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyRequestedPresence (  )  const [inline]

Asynchronous getter for the remote object property "RequestedPresence" of type Tp::SimplePresence.

The requested presence for this account. When this is changed, the account manager should attempt to manipulate the connection manager to make <tp:member-ref>CurrentPresence</tp:member-ref> match <tp:member-ref>RequestedPresence</tp:member-ref> as closely as possible. It should not be saved to any sort of persistent storage.

When the account manager automatically connects an account, it must signal this by setting the RequestedPresence to the same thing as the <tp:member-ref>AutomaticPresence</tp:member-ref>.

<tp:rationale> This corresponds to e.g. GetPresence and GetPresenceMessage in NMC 4.x. </tp:rationale>

The <tp:type>Connection_Presence_Type</tp:type> in this property MUST NOT be Unset, Unknown or Error.

<tp:rationale>

Requesting those presence types doesn't make sense. </tp:rationale>

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED void Tp::Client::AccountInterface::setRequestedPresence ( const Tp::SimplePresence &  newValue  )  [inline]

Setter for the remote object property "RequestedPresence".

Don't use this: it blocks the main loop.

Parameters:
newValue The value to set the property to.
Tp::PendingOperation* Tp::Client::AccountInterface::setPropertyRequestedPresence ( Tp::SimplePresence  newValue  )  [inline]

Asynchronous setter for the remote object property "RequestedPresence" of type Tp::SimplePresence.

The requested presence for this account. When this is changed, the account manager should attempt to manipulate the connection manager to make <tp:member-ref>CurrentPresence</tp:member-ref> match <tp:member-ref>RequestedPresence</tp:member-ref> as closely as possible. It should not be saved to any sort of persistent storage.

When the account manager automatically connects an account, it must signal this by setting the RequestedPresence to the same thing as the <tp:member-ref>AutomaticPresence</tp:member-ref>.

<tp:rationale> This corresponds to e.g. GetPresence and GetPresenceMessage in NMC 4.x. </tp:rationale>

The <tp:type>Connection_Presence_Type</tp:type> in this property MUST NOT be Unset, Unknown or Error.

<tp:rationale>

Requesting those presence types doesn't make sense. </tp:rationale>

Returns:
A pending operation which will emit finished when the property has been set.
TELEPATHY_QT4_DEPRECATED bool Tp::Client::AccountInterface::ChangingPresence (  )  const [inline]

Getter for the remote object property "ChangingPresence".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyChangingPresence() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyChangingPresence (  )  const [inline]

Asynchronous getter for the remote object property "ChangingPresence" of type bool.

If true, a change to the presence of this account is in progress.

Whenever <tp:member-ref>RequestedPresence</tp:member-ref> is set on an account that could go online, or whenever an account with a non-offline <tp:member-ref>RequestedPresence</tp:member-ref> becomes able to go online (for instance because <tp:member-ref>Enabled</tp:member-ref> or <tp:member-ref>Valid</tp:member-ref> changes to True), ChangingPresence MUST change to True, and the two property changes MUST be emitted in the same <tp:member-ref>AccountPropertyChanged</tp:member-ref> signal, before the Set method returns.

When the account manager succeeds or fails in changing the presence, or the connection disconnects due to an error, ChangingPresence MUST change to False as part of the same <tp:member-ref>AccountPropertyChanged</tp:member-ref> signal.

<tp:rationale>

This allows UIs to indicate that a presence change is in progress or has finished, even if the change was initiated by a different UI.

For instance, Maemo 5 and Empathy indicate a presence change by having the presence indicator alternate between the <tp:member-ref>RequestedPresence</tp:member-ref> and the <tp:member-ref>CurrentPresence</tp:member-ref>; they should start blinking when ChangingPresence becomes true, and stop when it becomes false. </tp:rationale>

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED QString Tp::Client::AccountInterface::NormalizedName (  )  const [inline]

Getter for the remote object property "NormalizedName".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyNormalizedName() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyNormalizedName (  )  const [inline]

Asynchronous getter for the remote object property "NormalizedName" of type QString.

The normalized user ID of the local user on this account (i.e. the string returned when the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref> method is called on the result of <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">GetSelfHandle</tp:dbus-ref> for an active connection).

It is unspecified whether this user ID is globally unique.

<tp:rationale>

As currently implemented, IRC user IDs are only unique within the same IRCnet. On some saner protocols, the user ID includes a DNS name which provides global uniqueness. </tp:rationale>

If this value is not known yet (which will always be the case for accounts that have never been online), it will be an empty string.

It is possible that this value will change if the connection manager's normalization algorithm changes, although this SHOULD be avoided.

<tp:rationale>

It's not always completely clear what normalization algorithm should be used; for instance, in Gabble, we currently use JIDs, but it would also have been reasonable to use xmpp URIs. </tp:rationale>

Returns:
A pending variant which will emit finished when the property has been retrieved.
TELEPATHY_QT4_DEPRECATED bool Tp::Client::AccountInterface::HasBeenOnline (  )  const [inline]

Getter for the remote object property "HasBeenOnline".

Don't use this: it blocks the main loop. Use the asynchronous requestPropertyHasBeenOnline() instead.

Returns:
The value of the property, or a default-constructed value if the property is not readable.
Tp::PendingVariant* Tp::Client::AccountInterface::requestPropertyHasBeenOnline (  )  const [inline]

Asynchronous getter for the remote object property "HasBeenOnline" of type bool.

If true, this account has successfully been put online at some point in the past. UIs could apply a policy that the 'account' parameter can only be edited in accounts that have never been online, or that ConnectAutomatically cannot be set on such accounts. The account manager should not enforce such policies, but it can expose enough information to UIs that the UI can decide what to do.

Returns:
A pending variant which will emit finished when the property has been retrieved.
Tp::PendingVariantMap* Tp::Client::AccountInterface::requestAllProperties (  )  const [inline]

Request all of the DBus properties on the interface.

Returns:
A pending variant map which will emit finished when the properties have been retrieved.
QDBusPendingReply Tp::Client::AccountInterface::Remove (  )  [inline, slot]

Begins a call to the D-Bus method "Remove" on the remote object.

Delete the account.

QDBusPendingReply<QStringList> Tp::Client::AccountInterface::UpdateParameters ( const QVariantMap &  set,
const QStringList &  unset 
) [inline, slot]

Begins a call to the D-Bus method "UpdateParameters" on the remote object.

Change the value of the <tp:member-ref>Parameters</tp:member-ref> property.

If any of the changed parameters' <tp:type>Conn_Mgr_Param_Flags</tp:type> include DBus_Property, the change will be applied immediately to the corresponding D-Bus Property on the active <tp:member-ref>Connection</tp:member-ref>, if there is one. Changes to other parameters will not take effect until the next time the account is disconnected and reconnected.

<tp:rationale>

In general, reconnecting is a destructive operation that shouldn't happen as a side-effect. In particular, migration tools that twiddle the settings of all accounts shouldn't cause an automatic disconnect and reconnect. </tp:rationale>

Parameters:
set A mapping from parameter names to their values. These parameters should be stored for future use.
unset A list of the names of parameters to be removed from the set of stored values, allowing the default values to be used. If the given parameters were not, in fact, stored, or even if they do not exist at all, the account manager MUST accept this without error.
Returns:

If all of the parameters had the DBus_Property flag, the empty list, signifying that no reconnection is required for the new parameters to take effect. For example, if the only parameter updated is ...Cellular.<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Cellular">MessageValidityPeriod</tp:dbus-ref>, the new value can be applied immediately to the connection.

Otherwise, a list of the names of parameters with changes that will not take effect until the account is reconnected. User interfaces that require "instant apply" semantics MAY call <tp:member-ref>Reconnect</tp:member-ref> in response to receiving a non-empty list. For example, if the caller updates both ...Anonymity.<tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection.Interface.Anonymity">AnonymityMandatory</tp:dbus-ref> and require-encryption, the former can be applied to the current connection, but the latter needs a reconnect to take effect, so this method should return ["require-encryption"].

QDBusPendingReply Tp::Client::AccountInterface::Reconnect (  )  [inline, slot]

Begins a call to the D-Bus method "Reconnect" on the remote object.

Re-connect this account. If the account is currently disconnected and the requested presence is offline, or if the account is not <tp:member-ref>Enabled</tp:member-ref> or not <tp:member-ref>Valid</tp:member-ref>, this does nothing.

If the account is disconnected and the requested presence is not offline, this forces an attempt to connect with the requested presence immediately.

If the account is connecting or connected, this is equivalent to remembering the current value of <tp:member-ref>RequestedPresence</tp:member-ref>, setting its value to (OFFLINE, "offline", ""), waiting for the change to take effect, then setting its value to the value that was previously remembered.

<tp:rationale>

Clients desiring "instant apply" semantics for CM parameters MAY call this method to achieve that. </tp:rationale>

In particular, if the account's <tp:member-ref>Connection</tp:member-ref> is in the Connecting state, calling this method causes the attempt to connect to be aborted and re-tried.

<tp:rationale>

This is necessary to ensure that the new parameters are picked up. </tp:rationale>

void Tp::Client::AccountInterface::Removed (  )  [signal]

Represents the signal "Removed" on the remote object.

This account has been removed. This is redundant with AccountRemoved, but it's still worth having, to avoid having to bind to AccountManager.AccountRemoved to tell you whether your Account is valid — ideally, an account-editing UI should only care about a single Account.

void Tp::Client::AccountInterface::AccountPropertyChanged ( const QVariantMap &  properties  )  [signal]

Represents the signal "AccountPropertyChanged" on the remote object.

The values of one or more properties on this interface (that do not specify that this signal does not apply to them) may have changed. This does not cover properties of other interfaces, which must provide their own change notification if appropriate.

Parameters:
properties A map from property names in this namespace (e.g. Nickname) to values. Properties whose values have not changed SHOULD be omitted, but this need not be done.
void Tp::Client::AccountInterface::invalidate ( Tp::DBusProxy *  proxy,
const QString &  error,
const QString &  message 
) [protected, virtual]

Reimplemented from Tp::AbstractInterface.

Property Documentation

QStringList Tp::Client::AccountInterface::Interfaces [read]

Represents property "Interfaces" on the remote object.

A list of the extra interfaces provided by this account.

QString Tp::Client::AccountInterface::DisplayName [read, write]

Represents property "DisplayName" on the remote object.

The user-visible name of this account. This SHOULD be chosen by the user at account creation time. The account creation user interface is responsible for setting a reasonable default value in the user's locale; something like "Jabber (bob@example.com)" would be sensible. This approximately corresponds to "display name" in NMC 4.x and Decibel.

QString Tp::Client::AccountInterface::Icon [read, write]

Represents property "Icon" on the remote object.

The name of an icon in the system's icon theme, such as "im-msn", or the empty string to not specify an icon. If the icon is set to an empty string, the account manager or any client MAY derive a default icon, for instance from the protocol. This approximately corresponds to mc_profile_get_icon_name (or possibly mc_profile_get_branding_icon_name) in NMC 4.x. It's accessed via the account rather than the profile because we no longer have profiles as a core concept.

bool Tp::Client::AccountInterface::Valid [read]

Represents property "Valid" on the remote object.

If true, this account is considered by the account manager to be complete and usable. If false, user action is required to make it usable, and it will never attempt to connect (for instance, this might be caused by the absence of a required parameter). For connection managers with a plugin architecture, like telepathy-haze, we have little or no control over the parameters offered; for platforms with package management, we have little or no control over the CMs offered. NMC 4.x would just pretend the account didn't exist in these circumstances, but silent data loss is bad, and UIs with CM-specific knowledge (or a user filling in newly-required parameters) might be able to rescue a broken account.

bool Tp::Client::AccountInterface::Enabled [read, write]

Represents property "Enabled" on the remote object.

This property gives the users the possibility to prevent an account from being used. This flag does not change the validity of the account.

A disabled account can never be put online.

<tp:rationale>

Use cases:

  • user has two or more accounts capable of calling contact X, but he doesn't want the UI to prompt him everytime about which one he wants to use for the call. He can then disable all the equivalent accounts but one.

  • There is some temporary server error and the user doesn't want to be be bother by error messages, or change the account configuration: temporarily disabling the account is quicker.

</tp:rationale>

The AccountManager SHOULD allow this property to be set on invalid accounts, but MUST NOT attempt to put invalid accounts online even if they become Enabled.

<tp:rationale>

There doesn't seem to be any good reason not to allow this. </tp:rationale>

QString Tp::Client::AccountInterface::Nickname [read, write]

Represents property "Nickname" on the remote object.

The nickname to set on this account for display to other contacts, as set by the user. When the account becomes connected, the account manager SHOULD set this as the user's alias using SetAliases if appropriate. In a later specification revision, we plan to separate the concepts of a contact's nickname as set by themselves, and the local name for them in our contact list (a "handle" or "pet name" as described in XEP-0165 and its references). The terminology change from alias to nickname here is a step in that direction. This corresponds to NMC 4.x mc_account_get_alias.

QString Tp::Client::AccountInterface::Service [read, write]

Represents property "Service" on the remote object.

Some protocols, like XMPP and SIP, are used by various different user-recognised brands, such as Google Talk and Ovi by Nokia. On accounts for such services, this property SHOULD be set to a string describing the service, which MUST consist only of ASCII letters, numbers and hyphen/minus signs, and start with a letter (matching the requirements for <tp:type>Protocol</tp:type>). For the jabber protocol, one of the following service names should be used if possible:

The <tp:member-ref>Icon</tp:member-ref> property SHOULD be set to a corresponding brand-specific icon name, if possible. In the future, this property may be used as an index into additional service-specific customizations. If this property is the empty string (or missing), the service is determined by the protocol name (either because this is a single-service protocol like msn, or because this is just a generic jabber or sip account without specific branding).

This property MAY be set, if appropriate, when calling <tp:dbus-ref namespace="org.freedesktop.Telepathy.AccountManager">CreateAccount</tp:dbus-ref>. Updating this property will fail on externally-stored accounts whose <tp:dbus-ref namespace="org.freedesktop.Telepathy.Account.Interface.Storage">StorageRestrictions</tp:dbus-ref> include Cannot_Set_Service.

QVariantMap Tp::Client::AccountInterface::Parameters [read]

Represents property "Parameters" on the remote object.

A map from connection manager parameter names (as in the <tp:dbus-ref namespace="org.freedesktop.Telepathy">ConnectionManager</tp:dbus-ref> interface) to their values. This property includes only those parameters that are stored for this account, and SHOULD only include those parameters that the user has explicitly set.

This property cannot be altered using Set() - use <tp:member-ref>UpdateParameters</tp:member-ref> instead.

Tp::SimplePresence Tp::Client::AccountInterface::AutomaticPresence [read, write]

Represents property "AutomaticPresence" on the remote object.

The presence status that this account should have if it is brought online.

<tp:rationale> In ITOS2007 and ITOS2008 this is a global preference, not visible on D-Bus (the "default presence"). "Automatic presence" better describes when it is used. </tp:rationale>

Setting this property MUST NOT actually change the account's status until the next time it is (re)connected for some reason.

The value of this property MUST be one that would be acceptable for <tp:member-ref>RequestedPresence</tp:member-ref>, with the additional restriction that the <tp:type>Connection_Presence_Type</tp:type> MUST NOT be Offline.

<tp:rationale>

Otherwise, it would not be possible to use this presence to bring the account online for a channel request. </tp:rationale>

bool Tp::Client::AccountInterface::ConnectAutomatically [read, write]

Represents property "ConnectAutomatically" on the remote object.

If true, the account manager SHOULD attempt to put this account online with the AutomaticPresence whenever possible (in the base Account interface this is deliberately left vague). If false, it MUST NOT put the account online automatically in response to, for instance, connectivity changes, but SHOULD still put the account online with the AutomaticPresence if requested by the user (for instance, if the user tries to start a conversation using this account). This approximately corresponds to NMC 4.x "enabled" and Decibel "autoreconnect".

QDBusObjectPath Tp::Client::AccountInterface::Connection [read]

Represents property "Connection" on the remote object.

Either the object path of the <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection</tp:dbus-ref> to this account, or the special value '/' if there is no connection.

If this object path is not '/', the Connection's well-known bus name can be derived from this object path by removing the first '/' and replacing subsequent '/' characters with '.'.

<tp:rationale> Object paths aren't nullable, so we can't use an empty string. </tp:rationale>

uint Tp::Client::AccountInterface::ConnectionStatus [read]

Represents property "ConnectionStatus" on the remote object.

If the Connection property is non-empty, the status of that connection. If the Connection property is the empty string, this property may either be Disconnected (indicating that the account manager is not attempting to bring it online), or Connecting (indicating that the account manager is attempting to connect). The account manager is expected to set this by observing signals from the Connection. If the AM is doing some sort of backoff/delay on reconnection attempts, the account's status is conceptually "Connecting" even though there is no Connection. This vaguely corresponds to GetCurrentStatus in NMC 4.x.

uint Tp::Client::AccountInterface::ConnectionStatusReason [read]

Represents property "ConnectionStatusReason" on the remote object.

The reason for the last change to ConnectionStatus. The account manager is expected to set this by observing signals from the Connection. If you weren't watching the Connection at the time it failed, you can't tell why - unless the AM can tell you. This is part of GetCurrentStatus in NMC 4.x.

QString Tp::Client::AccountInterface::ConnectionError [read]

Represents property "ConnectionError" on the remote object.

If the last connection to this account failed with an error, the D-Bus error name of that error; otherwise, the empty string. The account manager is expected to set this by observing the <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.ConnectionError</tp:dbus-ref> and <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.StatusChanged</tp:dbus-ref> signals.

If ConnectionError is received before the connection disconnects, its first argument should be used to set this property; otherwise, the Reason argument of StatusChanged should be converted to a suitable D-Bus error name.

Whenever the Connection connects successfully, this property should be reset to the empty string.

<tp:rationale>

This combines the state-recoverability of <tp:member-ref>ConnectionStatusReason</tp:member-ref> with the extensibility of Connection.ConnectionError. </tp:rationale>

QVariantMap Tp::Client::AccountInterface::ConnectionErrorDetails [read]

Represents property "ConnectionErrorDetails" on the remote object.

If the last connection to this account failed with an error, a mapping representing any additional information about the last disconnection; otherwise, the empty map. The keys and values are the same as for the second argument of <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.ConnectionError</tp:dbus-ref>.

Whenever the Connection connects successfully, this property should be reset to the empty map.

<tp:rationale>

This combines the state-recoverability of <tp:member-ref>ConnectionStatusReason</tp:member-ref> with the extensibility of Connection.ConnectionError. </tp:rationale>

Tp::SimplePresence Tp::Client::AccountInterface::CurrentPresence [read]

Represents property "CurrentPresence" on the remote object.

The actual presence. If the connection is not online, the Connection_Presence_Type SHOULD be Connection_Presence_Type_Offline. If the connection is online but does not support the SimplePresence interface, the type SHOULD be Connection_Presence_Type_Unset. The account manager is expected to set this by observing signals from the Connection. This corresponds to GetPresenceActual in NMC 4.x.

Tp::SimplePresence Tp::Client::AccountInterface::RequestedPresence [read, write]

Represents property "RequestedPresence" on the remote object.

The requested presence for this account. When this is changed, the account manager should attempt to manipulate the connection manager to make <tp:member-ref>CurrentPresence</tp:member-ref> match <tp:member-ref>RequestedPresence</tp:member-ref> as closely as possible. It should not be saved to any sort of persistent storage.

When the account manager automatically connects an account, it must signal this by setting the RequestedPresence to the same thing as the <tp:member-ref>AutomaticPresence</tp:member-ref>.

<tp:rationale> This corresponds to e.g. GetPresence and GetPresenceMessage in NMC 4.x. </tp:rationale>

The <tp:type>Connection_Presence_Type</tp:type> in this property MUST NOT be Unset, Unknown or Error.

<tp:rationale>

Requesting those presence types doesn't make sense. </tp:rationale>

bool Tp::Client::AccountInterface::ChangingPresence [read]

Represents property "ChangingPresence" on the remote object.

If true, a change to the presence of this account is in progress.

Whenever <tp:member-ref>RequestedPresence</tp:member-ref> is set on an account that could go online, or whenever an account with a non-offline <tp:member-ref>RequestedPresence</tp:member-ref> becomes able to go online (for instance because <tp:member-ref>Enabled</tp:member-ref> or <tp:member-ref>Valid</tp:member-ref> changes to True), ChangingPresence MUST change to True, and the two property changes MUST be emitted in the same <tp:member-ref>AccountPropertyChanged</tp:member-ref> signal, before the Set method returns.

When the account manager succeeds or fails in changing the presence, or the connection disconnects due to an error, ChangingPresence MUST change to False as part of the same <tp:member-ref>AccountPropertyChanged</tp:member-ref> signal.

<tp:rationale>

This allows UIs to indicate that a presence change is in progress or has finished, even if the change was initiated by a different UI.

For instance, Maemo 5 and Empathy indicate a presence change by having the presence indicator alternate between the <tp:member-ref>RequestedPresence</tp:member-ref> and the <tp:member-ref>CurrentPresence</tp:member-ref>; they should start blinking when ChangingPresence becomes true, and stop when it becomes false. </tp:rationale>

QString Tp::Client::AccountInterface::NormalizedName [read]

Represents property "NormalizedName" on the remote object.

The normalized user ID of the local user on this account (i.e. the string returned when the <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">InspectHandles</tp:dbus-ref> method is called on the result of <tp:dbus-ref namespace="org.freedesktop.Telepathy.Connection">GetSelfHandle</tp:dbus-ref> for an active connection).

It is unspecified whether this user ID is globally unique.

<tp:rationale>

As currently implemented, IRC user IDs are only unique within the same IRCnet. On some saner protocols, the user ID includes a DNS name which provides global uniqueness. </tp:rationale>

If this value is not known yet (which will always be the case for accounts that have never been online), it will be an empty string.

It is possible that this value will change if the connection manager's normalization algorithm changes, although this SHOULD be avoided.

<tp:rationale>

It's not always completely clear what normalization algorithm should be used; for instance, in Gabble, we currently use JIDs, but it would also have been reasonable to use xmpp URIs. </tp:rationale>

bool Tp::Client::AccountInterface::HasBeenOnline [read]

Represents property "HasBeenOnline" on the remote object.

If true, this account has successfully been put online at some point in the past. UIs could apply a policy that the 'account' parameter can only be edited in accounts that have never been online, or that ConnectAutomatically cannot be set on such accounts. The account manager should not enforce such policies, but it can expose enough information to UIs that the UI can decide what to do.

Copyright © 2008-2010 Collabora Ltd. and Nokia Corporation
Telepathy-Qt4 0.4.4