OssoABookAccountManager

OssoABookAccountManager — Management of Mission Control accounts.

Synopsis

                    OssoABookAccountManager;
OssoABookAccountManager* osso_abook_account_manager_new (void);
OssoABookAccountManager* osso_abook_account_manager_get_default
                                                        (void);

void                osso_abook_account_manager_set_active_accounts_only
                                                        (OssoABookAccountManager *manager,
                                                         gboolean setting);
gboolean            osso_abook_account_manager_is_active_accounts_only
                                                        (OssoABookAccountManager *manager);

McAccount*          osso_abook_account_manager_lookup_by_name
                                                        (OssoABookAccountManager *manager,
                                                         const char *name);
McAccount*          osso_abook_account_manager_lookup_by_vcard_field
                                                        (OssoABookAccountManager *manager,
                                                         const char *vcard_field,
                                                         const char *vcard_value);
const GList*        osso_abook_account_manager_get_primary_vcard_fields
                                                        (OssoABookAccountManager *manager);
const GList*        osso_abook_account_manager_get_secondary_vcard_fields
                                                        (OssoABookAccountManager *manager);
gboolean            osso_abook_account_manager_has_primary_vcard_field
                                                        (OssoABookAccountManager *manager,
                                                         const char *vcard_field);
gboolean            osso_abook_account_manager_has_secondary_vcard_field
                                                        (OssoABookAccountManager *manager,
                                                         const char *vcard_field);

TpDBusDaemon*       osso_abook_account_manager_get_dbus_daemon
                                                        (OssoABookAccountManager *manager);
TpConnectionPresenceType osso_abook_account_manager_get_presence
                                                        (OssoABookAccountManager *manager);

Description

The OssoABookAccountManager watches creation, removal and state changes of Mission Control accounts, and provides convenient access to the current set of Mission Control accounts.

It tries to fill the gaps libmcclient leaves.

See also: McAccount

Details

OssoABookAccountManager

typedef struct {
        GObject parent_instance;
} OssoABookAccountManager;

All the fields of this structure are private to the object's implementation and should never be accessed directly.


osso_abook_account_manager_new ()

OssoABookAccountManager* osso_abook_account_manager_new (void);

Creates a new OssoABookAccountManager instance.

Returns : A newly allocated OssoABookAccountManager.

osso_abook_account_manager_get_default ()

OssoABookAccountManager* osso_abook_account_manager_get_default
                                                        (void);

Retreive the default OssoABookAccountManager.

Returns : The default OssoABookAccountManager. This object is owned by the library and must not be unreferenced.

osso_abook_account_manager_set_active_accounts_only ()

void                osso_abook_account_manager_set_active_accounts_only
                                                        (OssoABookAccountManager *manager,
                                                         gboolean setting);

Changes the current value of the "active-accounts-only" property.

manager : a OssoABookAccountManager, or NULL for the default instance
setting : the new property value

osso_abook_account_manager_is_active_accounts_only ()

gboolean            osso_abook_account_manager_is_active_accounts_only
                                                        (OssoABookAccountManager *manager);

Queries the current value of the "active-accounts-only" property.

manager : a OssoABookAccountManager, or NULL for the default instance
Returns : Current property value.

osso_abook_account_manager_lookup_by_name ()

McAccount*          osso_abook_account_manager_lookup_by_name
                                                        (OssoABookAccountManager *manager,
                                                         const char *name);

Finds the McAccount with the given unique name.

manager : a OssoABookAccountManager, or NULL for the default instance
name : the unique McAccount name
Returns : The requested McAccount, or NULL when no such account is known.

osso_abook_account_manager_lookup_by_vcard_field ()

McAccount*          osso_abook_account_manager_lookup_by_vcard_field
                                                        (OssoABookAccountManager *manager,
                                                         const char *vcard_field,
                                                         const char *vcard_value);

Finds the McAccount which can be used to contact the communication handle described by vcard_field and vcard_value.

manager : a OssoABookAccountManager, or NULL for the default instance
vcard_field : the name of the vCard attribute
vcard_value : the value of the vCard attribute
Returns : The requested McAccount, or NULL when no such account is known.

osso_abook_account_manager_get_primary_vcard_fields ()

const GList*        osso_abook_account_manager_get_primary_vcard_fields
                                                        (OssoABookAccountManager *manager);

Lists the vCard fields for all preferred communication method supported by the currently known Mission Control accounts.

manager : a OssoABookAccountManager, or NULL for the default instance
Returns : The list of vCard attribute names. The list is owned by the object and must not be freed.

osso_abook_account_manager_get_secondary_vcard_fields ()

const GList*        osso_abook_account_manager_get_secondary_vcard_fields
                                                        (OssoABookAccountManager *manager);

Lists the vCard fields for all additional communication methods currently known Mission Control accounts.

manager : a OssoABookAccountManager, or NULL for the default instance
Returns : The list of vCard attribute names. The list is owned by the object and must not be freed.

osso_abook_account_manager_has_primary_vcard_field ()

gboolean            osso_abook_account_manager_has_primary_vcard_field
                                                        (OssoABookAccountManager *manager,
                                                         const char *vcard_field);

Checks if there is a Mission Control account which prefers the communication method described by vcard_field.

manager : a OssoABookAccountManager, or NULL for the default instance
vcard_field : the vCard attribute name for some communication method
Returns : TRUE if there is such an McAccount, and FALSE otherwise.

osso_abook_account_manager_has_secondary_vcard_field ()

gboolean            osso_abook_account_manager_has_secondary_vcard_field
                                                        (OssoABookAccountManager *manager,
                                                         const char *vcard_field);

Checks if there is a Mission Control account which also supports the communication method described by vcard_field.

manager : a OssoABookAccountManager, or NULL for the default instance
vcard_field : the vCard attribute name for some communication method
Returns : TRUE if there is such an McAccount, and FALSE otherwise.

osso_abook_account_manager_get_dbus_daemon ()

TpDBusDaemon*       osso_abook_account_manager_get_dbus_daemon
                                                        (OssoABookAccountManager *manager);

Retreives the TpDBusDaemon object used when this OssoABookAccountManager communicates with Telepathy or Mission Control.

manager : a OssoABookAccountManager, or NULL for the default instance
Returns : The TpDBusDaemon of this object.

osso_abook_account_manager_get_presence ()

TpConnectionPresenceType osso_abook_account_manager_get_presence
                                                        (OssoABookAccountManager *manager);

Queries the current value of the "presence" property.

manager : a OssoABookAccountManager, or NULL for the default instance
Returns : Current property value.