Evolution-Data-Server Manual: Utilities (libedataserver) | ||||
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
ESourceGoaESourceGoa — ESource extension for GNOME Online Accounts |
Synopsis
#include <libedataserver/libedataserver.h> struct ESourceGoa; #define E_SOURCE_EXTENSION_GOA const gchar * e_source_goa_get_account_id (ESourceGoa *extension
); gchar * e_source_goa_dup_account_id (ESourceGoa *extension
); void e_source_goa_set_account_id (ESourceGoa *extension
,const gchar *account_id
); const gchar * e_source_goa_get_calendar_url (ESourceGoa *extension
); gchar * e_source_goa_dup_calendar_url (ESourceGoa *extension
); void e_source_goa_set_calendar_url (ESourceGoa *extension
,const gchar *calendar_url
); const gchar * e_source_goa_get_contacts_url (ESourceGoa *extension
); gchar * e_source_goa_dup_contacts_url (ESourceGoa *extension
); void e_source_goa_set_contacts_url (ESourceGoa *extension
,const gchar *contacts_url
);
Properties
"account-id" gchar* : Read / Write / Construct "calendar-url" gchar* : Read / Write / Construct "contacts-url" gchar* : Read / Write / Construct
Description
The ESourceGoa extension associates an ESource with a GoaAccount. This extension is usually found in a top-level ESource, with various mail, calendar and address book data sources as children.
Access the extension as follows:
1 2 3 4 5 |
#include <libedataserver/libedataserver.h> ESourceGoa *extension; extension = e_source_get_extension (source, E_SOURCE_EXTENSION_GOA); |
Details
struct ESourceGoa
struct ESourceGoa;
Contains only private data that should be read and manipulated using the functions below.
Since 3.6
E_SOURCE_EXTENSION_GOA
#define E_SOURCE_EXTENSION_GOA "GNOME Online Accounts"
Pass this extension name to e_source_get_extension()
to access
ESourceGoa. This is also used as a group name in key files.
Since 3.6
e_source_goa_get_account_id ()
const gchar * e_source_goa_get_account_id (ESourceGoa *extension
);
Returns the identifier string of the GNOME Online Account associated
with the ESource to which extension
belongs.
|
an ESourceGoa |
Returns : |
the associated GNOME Online Account ID |
Since 3.6
e_source_goa_dup_account_id ()
gchar * e_source_goa_dup_account_id (ESourceGoa *extension
);
Thread-safe variation of e_source_goa_get_account_id()
.
Use this function when accessing extension
from multiple threads.
The returned string should be freed with g_free()
when no longer needed.
|
an ESourceGoa |
Returns : |
a newly-allocated copy of "account-id" |
Since 3.6
e_source_goa_set_account_id ()
void e_source_goa_set_account_id (ESourceGoa *extension
,const gchar *account_id
);
Sets the identifier string of the GNOME Online Account associated
with the ESource to which extension
belongs.
The internal copy of account_id
is automatically stripped of leading
and trailing whitespace. If the resulting string is empty, NULL
is set
instead.
|
an ESourceGoa |
|
the associated GNOME Online Account ID, or NULL . [allow-none]
|
Since 3.6
e_source_goa_get_calendar_url ()
const gchar * e_source_goa_get_calendar_url (ESourceGoa *extension
);
Returns the calendar URL string of the GNOME Online Account associated
with the ESource to which extension
belongs. Can be NULL
or an empty
string for accounts not supporting this property.
|
an ESourceGoa |
Returns : |
the associated GNOME Online Account calendar URL |
Since 3.8
e_source_goa_dup_calendar_url ()
gchar * e_source_goa_dup_calendar_url (ESourceGoa *extension
);
Thread-safe variation of e_source_goa_get_calendar_url()
.
Use this function when accessing extension
from multiple threads.
The returned string should be freed with g_free()
when no longer needed.
|
an ESourceGoa |
Returns : |
a newly-allocated copy of "calendar-url" |
Since 3.8
e_source_goa_set_calendar_url ()
void e_source_goa_set_calendar_url (ESourceGoa *extension
,const gchar *calendar_url
);
Sets the calendar URL of the GNOME Online Account associated
with the ESource to which extension
belongs.
The internal copy of calendar_url
is automatically stripped of leading
and trailing whitespace. If the resulting string is empty, NULL
is set
instead.
|
an ESourceGoa |
|
the associated GNOME Online Account
calendar URL, or NULL . [allow-none]
|
Since 3.8
e_source_goa_get_contacts_url ()
const gchar * e_source_goa_get_contacts_url (ESourceGoa *extension
);
Returns the contacts URL string of the GNOME Online Account associated
with the ESource to which extension
belongs. Can be NULL
or an empty
string for accounts not supporting this property.
|
an ESourceGoa |
Returns : |
the associated GNOME Online Account contacts URL |
Since 3.8
e_source_goa_dup_contacts_url ()
gchar * e_source_goa_dup_contacts_url (ESourceGoa *extension
);
Thread-safe variation of e_source_goa_get_contacts_url()
.
Use this function when accessing extension
from multiple threads.
The returned string should be freed with g_free()
when no longer needed.
|
an ESourceGoa |
Returns : |
a newly-allocated copy of "contacts-url" |
Since 3.8
e_source_goa_set_contacts_url ()
void e_source_goa_set_contacts_url (ESourceGoa *extension
,const gchar *contacts_url
);
Sets the contacts URL of the GNOME Online Account associated
with the ESource to which extension
belongs.
The internal copy of contacts_url
is automatically stripped of leading
and trailing whitespace. If the resulting string is empty, NULL
is set
instead.
|
an ESourceGoa |
|
the associated GNOME Online Account
contacts URL, or NULL . [allow-none]
|
Since 3.8