Account

---

Object Hierarchy:

Description:

Content:

Properties:

• public uint automatic_presence_type { get; }
  The account's automatic presence type (a ConnectionPresenceType).
• public string automatic_status { owned get; }
  The string status name to use in conjunction with the automatic_presence_type.
• public string automatic_status_message { owned get; }
  The user-defined message to use in conjunction with the automatic_presence_type.
• public bool changing_presence { get; }
  true if an attempt is currently being made to change the account's presence (#TpAccount:current-presence-type, current_status and current_status_message) to match its requested presence (#TpAccount:requested-presence-type, requested_status and requested_status_message).
• public string cm_name { get; }
  The account's connection manager name.
• public bool connect_automatically { get; }
  Whether the account should connect automatically or not.
• public Connection connection { get; }
  The connection of the account, or null if account is offline.
• public string connection_error { owned get; }
  The D-Bus error name for the last disconnection or connection failure, (in particular, TP_ERROR_STR_CANCELLED if it was disconnected by user request), or null if the account is connected.
• public HashTable<void*,void*> connection_error_details { owned get; }
  A map from string to Value containing extensible error details related to connection_error.
• public string connection_manager { get; }
  The account's connection manager name.
• public uint connection_status { get; }
  The account's connection status type (a ConnectionStatus).
• public uint connection_status_reason { get; }
  The account's connection status reason (a ConnectionStatusReason).
• public uint current_presence_type { get; }
  The account connection's current presence type (a ConnectionPresenceType).
• public string current_status { owned get; }
  The current Status string of the account.
• public string current_status_message { owned get; }
  The current status message message of the account.
• public string display_name { get; }
  The account's display name, from the DisplayName property.
• public bool enabled { get; }
  Whether this account is enabled or not.
• public bool has_been_online { get; }
  Whether this account has been online or not.
• public string icon_name { get; }
  The account's icon name.
• public string nickname { get; }
  The nickname that should be set for the user on this account.
• public string normalized_name { get; }
  The normalized form of the user's own unique identifier on this protocol.
• public string protocol { get; }
  The account's machine-readable protocol name, such as "jabber", "msn" or "local-xmpp".
• public string protocol_name { get; }
  The account's machine-readable protocol name, such as "jabber", "msn" or "local-xmpp".
• public uint requested_presence_type { get; }
  The account's requested presence type (a ConnectionPresenceType).
• public string requested_status { owned get; }
  The requested Status string of the account.
• public string requested_status_message { owned get; }
  The requested status message message of the account.
• public string service { get; }
  A machine-readable name identifying a specific service to which this account connects, or a copy of protocol if there is no more specific service.
• public Value storage_identifier { get; }
  The storage identifier for this account.
• public Variant storage_identifier_variant { owned get; }
  Provider-specific information used to identify this account.
• public string storage_provider { get; }
  The storage provider for this account.
• public uint storage_restrictions { get; }
  The storage restrictions for this account.
• public string[] supersedes { get; }
  The object paths of previously-active accounts superseded by this one.
• public string[] uri_schemes { get; }
  If the TP_ACCOUNT_FEATURE_ADDRESSING feature has been prepared successfully, a list of additional URI schemes for which this account should be used if possible.
• public bool valid { get; }
  Whether this account is valid.

Static methods:

• public static Quark get_feature_quark_addressing ()
• public static Quark get_feature_quark_connection ()
• public static Quark get_feature_quark_core ()
• public static Quark get_feature_quark_storage ()
• public static void init_known_interfaces ()
  Ensure that the known interfaces for TpAccount have been set up.
• public static bool parse_object_path (string object_path, out string cm, out string protocol, out string account_id) throws Error
  Validates and parses a Telepathy Account's object path, extracting the connection manager's name, the protocol, and the account's unique identifier from the path.

Creation methods:

• public Account (DBusDaemon bus_daemon, string object_path) throws Error
  Convenience function to create a new account proxy.

Methods:

• public bool associated_with_uri_scheme (string scheme)
• public unowned Binding bind_connection_status_to_property (void* target, string target_property, bool invert)
  Binds the connection_status of this to the boolean property of another object using a Binding such that the target_property will be set to true when this is connected (and invert is false).
• public string? dup_detailed_error_vardict (out Variant details)
  If the account's connection is not connected, return the D-Bus error name with which it last disconnected or failed to connect (in particular, this is TP_ERROR_STR_CANCELLED if it was disconnected by a user request).
• public Variant dup_parameters_vardict ()
  Returns the parameters of the account, in a variant of type VARDICT where the keys are parameter names (account, password, require-encryption etc.
• public Variant dup_storage_identifier_variant ()
  Return provider-specific information used to identify this account.
• public async Variant dup_storage_specific_information_vardict_async () throws Error
  Makes an asynchronous request of this 's StorageSpecificInformation property (part of the Account.
• public unowned Connection ensure_connection (string path)
  Set the connection of the account by specifying the connection object path.
• public ConnectionPresenceType get_automatic_presence (out unowned string status, out string status_message)
  Gets the automatic presence, status and status message of account.
• public async unowned Array<uint8> get_avatar_async () throws Error
  Requests an asynchronous get of this 's avatar.
• public bool get_changing_presence ()
• public unowned string get_cm_name ()
• public bool get_connect_automatically ()
• public unowned Connection get_connection ()
• public unowned string get_connection_manager ()
• public ConnectionStatus get_connection_status (out ConnectionStatusReason reason)
  Gets the connection status and reason from this.
• public ConnectionPresenceType get_current_presence (out string status, out string status_message)
  Gets the current presence, status and status message of this.
• public unowned string get_display_name ()
• public bool get_has_been_online ()
• public unowned string get_icon_name ()
• public unowned string get_nickname ()
• public unowned string get_normalized_name ()
• public unowned HashTable<string,Value?> get_parameters ()
  Returns the parameters of the account, in a hash table where each string is the parameter name (account, password, require-encryption etc.
• public unowned string get_path_suffix ()
  Returns the portion of this's object path after the standard ACCOUNT_OBJECT_PATH_BASE prefix, of the form "cm/protocol/acct".
• public unowned string get_protocol ()
• public unowned string get_protocol_name ()
• public ConnectionPresenceType get_requested_presence (out unowned string status, out string status_message)
  Gets the requested presence, status and status message of this.
• public unowned string get_service ()
• public unowned Value? get_storage_identifier ()
• public unowned string get_storage_provider ()
• public StorageRestrictionFlags get_storage_restrictions ()
• public async unowned HashTable<string,Value?> get_storage_specific_information_async () throws Error
  Makes an asynchronous request of this 's StorageSpecificInformation property (part of the Account.
• public unowned string[] get_supersedes ()
  Return the same thing as the supersedes property, in a way that may be more convenient for C code.
• public unowned string[] get_uri_schemes ()
  Return the uri_schemes property
• public bool is_enabled ()
• public bool is_valid ()
• public async bool reconnect_async () throws Error
  Requests an asynchronous reconnect of this .
• public async bool remove_async () throws Error
  Requests an asynchronous removal of this .
• public async bool request_presence_async (ConnectionPresenceType type, string status, string message) throws Error
  Requests an asynchronous change of presence on this.
• public async bool set_automatic_presence_async (ConnectionPresenceType type, string status, string message) throws Error
  Requests an asynchronous change of this 's automatic presence.
• public async bool set_avatar_async (uint8[]? avatar, string? mime_type) throws Error
  Requests an asynchronous change of the Avatar parameter on this.
• public async bool set_connect_automatically_async (bool connect_automatically) throws Error
  Requests an asynchronous set of the ConnectAutomatically property of this.
• public async bool set_display_name_async (string display_name) throws Error
  Requests an asynchronous set of the DisplayName property of this.
• public async bool set_enabled_async (bool enabled) throws Error
  Requests an asynchronous set of the Enabled property of this.
• public async bool set_icon_name_async (string icon_name) throws Error
  Requests an asynchronous set of the Icon property of this.
• public async bool set_nickname_async (string nickname) throws Error
  Requests an asynchronous change of the Nickname parameter on this.
• public async bool set_service_async (string service) throws Error
  Requests an asynchronous set of the Service property on this.
• public async bool set_uri_scheme_association_async (string scheme, bool associate) throws Error
  Add scheme to the list of additional URI schemes that would be returned by get_uri_schemes, or remove it from that list.
• public async bool update_parameters_async (HashTable<string,Value?> parameters, string unset_parameters, out string[] reconnect_required) throws Error
  Requests an asynchronous update of parameters of this.
• public async bool update_parameters_vardict_async (Variant parameters, string[] unset_parameters, out string[] reconnect_required) throws Error
  Requests an asynchronous update of parameters of this.

Signals:

• public signal void avatar_changed ()
  Emitted when the avatar changes.
• public signal void presence_changed (uint presence, string status, string status_message)
  Emitted when the presence of the account changes.
• public signal void status_changed (uint old_status, uint new_status, uint reason, string? dbus_error_name, HashTable<string,Value?> details)
  Emitted when the connection status on the account changes.

Inherited Members: