Osso Addressbook Reference Manual | ||||
---|---|---|---|---|
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);
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
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.
OssoABookAccountManager* osso_abook_account_manager_new (void);
Creates a new OssoABookAccountManager instance.
Returns : | A newly allocated OssoABookAccountManager. |
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. |
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 |
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. |
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.
|
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.
|
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. |
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. |
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.
|
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.
|
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. |
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. |