| Evolution API Reference: libebook, the Addressbook Library | ||||
|---|---|---|---|---|
EContact;
EContactAddress;
EContactCert;
EContactDate;
enum EContactField;
EContactGeo;
EContactName;
EContactPhoto;
enum EContactPhotoType;
EContact* e_contact_new (void);
EContact* e_contact_new_from_vcard (const char *vcard);
EContact* e_contact_duplicate (EContact *contact);
gpointer e_contact_get (EContact *contact,
EContactField field_id);
gconstpointer e_contact_get_const (EContact *contact,
EContactField field_id);
void e_contact_set (EContact *contact,
EContactField field_id,
const gpointer value);
EContactDate* e_contact_date_new (void);
EContactDate* e_contact_date_from_string (const char *str);
char* e_contact_date_to_string (EContactDate *dt);
gboolean e_contact_date_equal (EContactDate *dt1,
EContactDate *dt2);
EContactName* e_contact_name_new (void);
char* e_contact_name_to_string (const EContactName *name);
EContactName* e_contact_name_from_string (const char *name_str);
EContactName* e_contact_name_copy (EContactName *n);
void e_contact_date_free (EContactDate *date);
void e_contact_name_free (EContactName *name);
void e_contact_photo_free (EContactPhoto *photo);
void e_contact_address_free (EContactAddress *address);
const char* e_contact_field_name (EContactField field_id);
const char* e_contact_pretty_name (EContactField field_id);
EContactField e_contact_field_id (const char *field_name);
void e_contact_cert_free (EContactCert *cert);
EContactField e_contact_field_id_from_vcard (const char *vcard_field);
void e_contact_geo_free (EContactGeo *geo);
GList* e_contact_get_attributes (EContact *contact,
EContactField field_id);
gboolean e_contact_inline_data (EContact *contact);
gboolean e_contact_is_syncable (EContact *contact);
gboolean e_contact_persist_data (EContact *contact,
const char *dir);
void e_contact_set_attributes (EContact *contact,
EContactField field_id,
GList *attributes);
const char* e_contact_vcard_attribute (EContactField field_id);
"Rev" gchar* : Read / Write "address" gpointer : Read / Write "address-home" EContactAddress* : Read / Write "address-label-home" gchar* : Read / Write "address-label-other" gchar* : Read / Write "address-label-work" gchar* : Read / Write "address-other" EContactAddress* : Read / Write "address-work" EContactAddress* : Read / Write "anniversary" EContactDate* : Read / Write "assistant" gchar* : Read / Write "assistant-phone" gchar* : Read / Write "birth-date" EContactDate* : Read / Write "blog-url" gchar* : Read / Write "book-uri" gchar* : Read / Write "business-fax" gchar* : Read / Write "business-phone" gchar* : Read / Write "business-phone-2" gchar* : Read / Write "callback-phone" gchar* : Read / Write "caluri" gchar* : Read / Write "car-phone" gchar* : Read / Write "categories" gchar* : Read / Write "category-list" gpointer : Read / Write "company-phone" gchar* : Read / Write "email" gpointer : Read / Write "email-1" gchar* : Read / Write "email-2" gchar* : Read / Write "email-3" gchar* : Read / Write "email-4" gchar* : Read / Write "family-name" gchar* : Read / Write "fburl" gchar* : Read / Write "file-as" gchar* : Read / Write "full-name" gchar* : Read / Write "geo" EContactGeo* : Read / Write "given-name" gchar* : Read / Write "home-fax" gchar* : Read / Write "home-phone" gchar* : Read / Write "home-phone-2" gchar* : Read / Write "homepage-url" gchar* : Read / Write "icscalendar" gchar* : Read / Write "id" gchar* : Read / Write "im-aim" gpointer : Read / Write "im-aim-home-1" gchar* : Read / Write "im-aim-home-2" gchar* : Read / Write "im-aim-home-3" gchar* : Read / Write "im-aim-work-1" gchar* : Read / Write "im-aim-work-2" gchar* : Read / Write "im-aim-work-3" gchar* : Read / Write "im-gadugadu" gpointer : Read / Write "im-gadugadu-home-1" gchar* : Read / Write "im-gadugadu-home-2" gchar* : Read / Write "im-gadugadu-home-3" gchar* : Read / Write "im-gadugadu-work-1" gchar* : Read / Write "im-gadugadu-work-2" gchar* : Read / Write "im-gadugadu-work-3" gchar* : Read / Write "im-groupwise" gpointer : Read / Write "im-groupwise-home-1" gchar* : Read / Write "im-groupwise-home-2" gchar* : Read / Write "im-groupwise-home-3" gchar* : Read / Write "im-groupwise-work-1" gchar* : Read / Write "im-groupwise-work-2" gchar* : Read / Write "im-groupwise-work-3" gchar* : Read / Write "im-icq" gpointer : Read / Write "im-icq-home-1" gchar* : Read / Write "im-icq-home-2" gchar* : Read / Write "im-icq-home-3" gchar* : Read / Write "im-icq-work-1" gchar* : Read / Write "im-icq-work-2" gchar* : Read / Write "im-icq-work-3" gchar* : Read / Write "im-jabber" gpointer : Read / Write "im-jabber-home-1" gchar* : Read / Write "im-jabber-home-2" gchar* : Read / Write "im-jabber-home-3" gchar* : Read / Write "im-jabber-work-1" gchar* : Read / Write "im-jabber-work-2" gchar* : Read / Write "im-jabber-work-3" gchar* : Read / Write "im-msn" gpointer : Read / Write "im-msn-home-1" gchar* : Read / Write "im-msn-home-2" gchar* : Read / Write "im-msn-home-3" gchar* : Read / Write "im-msn-work-1" gchar* : Read / Write "im-msn-work-2" gchar* : Read / Write "im-msn-work-3" gchar* : Read / Write "im-skype" gpointer : Read / Write "im-skype-home-1" gchar* : Read / Write "im-skype-home-2" gchar* : Read / Write "im-skype-home-3" gchar* : Read / Write "im-skype-work-1" gchar* : Read / Write "im-skype-work-2" gchar* : Read / Write "im-skype-work-3" gchar* : Read / Write "im-yahoo" gpointer : Read / Write "im-yahoo-home-1" gchar* : Read / Write "im-yahoo-home-2" gchar* : Read / Write "im-yahoo-home-3" gchar* : Read / Write "im-yahoo-work-1" gchar* : Read / Write "im-yahoo-work-2" gchar* : Read / Write "im-yahoo-work-3" gchar* : Read / Write "isdn-phone" gchar* : Read / Write "list" gboolean : Read / Write "list-show-addresses" gboolean : Read / Write "logo" EContactPhoto* : Read / Write "mailer" gchar* : Read / Write "manager" gchar* : Read / Write "mobile-phone" gchar* : Read / Write "name" EContactName* : Read / Write "name-or-org" gchar* : Read "nickname" gchar* : Read / Write "note" gchar* : Read / Write "office" gchar* : Read / Write "org" gchar* : Read / Write "org-unit" gchar* : Read / Write "other-fax" gchar* : Read / Write "other-phone" gchar* : Read / Write "pager" gchar* : Read / Write "phone" gpointer : Read / Write "photo" EContactPhoto* : Read / Write "primary-phone" gchar* : Read / Write "radio" gchar* : Read / Write "role" gchar* : Read / Write "sip" gpointer : Read / Write "spouse" gchar* : Read / Write "telex" gchar* : Read / Write "title" gchar* : Read / Write "tty" gchar* : Read / Write "video-url" gchar* : Read / Write "wants-html" gboolean : Read / Write "x509Cert" EContactCert* : Read / Write
EContact is a contact in the address book. It is meant to be a simpler way to access contact attributes than EVCard (which EContacts are a subclass of). This simplification comes at a cost of flexibility (particularly for non-trivial fields, like the structured name).
typedef struct _EContact EContact;
All the fields of this structure are private to the object's implementation and should never be accessed directly.
typedef struct {
char *address_format;
char *po;
char *ext;
char *street;
char *locality;
char *region;
char *code;
char *country;
} EContactAddress;
A structured representation of the contact's ADR vCard field.
char *address_format; |
the two letter country code that determines the format/meaning of the following fields |
char *po; |
the post office box |
char *ext; |
an extra line for the address (e.g., "Apt. 101", "c/o John Doe"). Locale-specific. |
char *street; |
the street and number |
char *locality; |
usually "city", though this depends upon the locale |
char *region; |
region, province, or state (locale-specific) |
char *code; |
postal/zip code |
char *country; |
country |
typedef struct {
gsize length;
char *data;
} EContactCert;
A structured field for an X.509 certificate.
gsize length; |
the length of the certificate |
char *data; |
the actual data |
typedef struct {
unsigned int year;
unsigned int month;
unsigned int day;
} EContactDate;
A structured date field.
unsigned int year; |
the year |
unsigned int month; |
the month |
unsigned int day; |
the day |
typedef enum {
E_CONTACT_UID = 1, /* string field */
E_CONTACT_FILE_AS, /* string field */
E_CONTACT_BOOK_URI, /* string field */
/* Name fields */
E_CONTACT_FULL_NAME, /* string field */
E_CONTACT_GIVEN_NAME, /* synthetic string field */
E_CONTACT_FAMILY_NAME, /* synthetic string field */
E_CONTACT_NICKNAME, /* string field */
/* Email fields */
E_CONTACT_EMAIL_1, /* synthetic string field */
E_CONTACT_EMAIL_2, /* synthetic string field */
E_CONTACT_EMAIL_3, /* synthetic string field */
E_CONTACT_EMAIL_4, /* synthetic string field */
E_CONTACT_MAILER, /* string field */
/* Address Labels */
E_CONTACT_ADDRESS_LABEL_HOME, /* synthetic string field */
E_CONTACT_ADDRESS_LABEL_WORK, /* synthetic string field */
E_CONTACT_ADDRESS_LABEL_OTHER, /* synthetic string field */
/* Phone fields */
E_CONTACT_PHONE_ASSISTANT,
E_CONTACT_PHONE_BUSINESS,
E_CONTACT_PHONE_BUSINESS_2,
E_CONTACT_PHONE_BUSINESS_FAX,
E_CONTACT_PHONE_CALLBACK,
E_CONTACT_PHONE_CAR,
E_CONTACT_PHONE_COMPANY,
E_CONTACT_PHONE_HOME,
E_CONTACT_PHONE_HOME_2,
E_CONTACT_PHONE_HOME_FAX,
E_CONTACT_PHONE_ISDN,
E_CONTACT_PHONE_MOBILE,
E_CONTACT_PHONE_OTHER,
E_CONTACT_PHONE_OTHER_FAX,
E_CONTACT_PHONE_PAGER,
E_CONTACT_PHONE_PRIMARY,
E_CONTACT_PHONE_RADIO,
E_CONTACT_PHONE_TELEX,
E_CONTACT_PHONE_TTYTDD,
/* Organizational fields */
E_CONTACT_ORG, /* string field */
E_CONTACT_ORG_UNIT, /* string field */
E_CONTACT_OFFICE, /* string field */
E_CONTACT_TITLE, /* string field */
E_CONTACT_ROLE, /* string field */
E_CONTACT_MANAGER, /* string field */
E_CONTACT_ASSISTANT, /* string field */
/* Web fields */
E_CONTACT_HOMEPAGE_URL, /* string field */
E_CONTACT_BLOG_URL, /* string field */
/* Contact categories */
E_CONTACT_CATEGORIES, /* string field */
/* Collaboration fields */
E_CONTACT_CALENDAR_URI, /* string field */
E_CONTACT_FREEBUSY_URL, /* string field */
E_CONTACT_ICS_CALENDAR, /* string field */
E_CONTACT_VIDEO_URL, /* string field */
/* misc fields */
E_CONTACT_SPOUSE, /* string field */
E_CONTACT_NOTE, /* string field */
E_CONTACT_IM_AIM_HOME_1, /* Synthetic string field */
E_CONTACT_IM_AIM_HOME_2, /* Synthetic string field */
E_CONTACT_IM_AIM_HOME_3, /* Synthetic string field */
E_CONTACT_IM_AIM_WORK_1, /* Synthetic string field */
E_CONTACT_IM_AIM_WORK_2, /* Synthetic string field */
E_CONTACT_IM_AIM_WORK_3, /* Synthetic string field */
E_CONTACT_IM_GROUPWISE_HOME_1, /* Synthetic string field */
E_CONTACT_IM_GROUPWISE_HOME_2, /* Synthetic string field */
E_CONTACT_IM_GROUPWISE_HOME_3, /* Synthetic string field */
E_CONTACT_IM_GROUPWISE_WORK_1, /* Synthetic string field */
E_CONTACT_IM_GROUPWISE_WORK_2, /* Synthetic string field */
E_CONTACT_IM_GROUPWISE_WORK_3, /* Synthetic string field */
E_CONTACT_IM_JABBER_HOME_1, /* Synthetic string field */
E_CONTACT_IM_JABBER_HOME_2, /* Synthetic string field */
E_CONTACT_IM_JABBER_HOME_3, /* Synthetic string field */
E_CONTACT_IM_JABBER_WORK_1, /* Synthetic string field */
E_CONTACT_IM_JABBER_WORK_2, /* Synthetic string field */
E_CONTACT_IM_JABBER_WORK_3, /* Synthetic string field */
E_CONTACT_IM_YAHOO_HOME_1, /* Synthetic string field */
E_CONTACT_IM_YAHOO_HOME_2, /* Synthetic string field */
E_CONTACT_IM_YAHOO_HOME_3, /* Synthetic string field */
E_CONTACT_IM_YAHOO_WORK_1, /* Synthetic string field */
E_CONTACT_IM_YAHOO_WORK_2, /* Synthetic string field */
E_CONTACT_IM_YAHOO_WORK_3, /* Synthetic string field */
E_CONTACT_IM_MSN_HOME_1, /* Synthetic string field */
E_CONTACT_IM_MSN_HOME_2, /* Synthetic string field */
E_CONTACT_IM_MSN_HOME_3, /* Synthetic string field */
E_CONTACT_IM_MSN_WORK_1, /* Synthetic string field */
E_CONTACT_IM_MSN_WORK_2, /* Synthetic string field */
E_CONTACT_IM_MSN_WORK_3, /* Synthetic string field */
E_CONTACT_IM_ICQ_HOME_1, /* Synthetic string field */
E_CONTACT_IM_ICQ_HOME_2, /* Synthetic string field */
E_CONTACT_IM_ICQ_HOME_3, /* Synthetic string field */
E_CONTACT_IM_ICQ_WORK_1, /* Synthetic string field */
E_CONTACT_IM_ICQ_WORK_2, /* Synthetic string field */
E_CONTACT_IM_ICQ_WORK_3, /* Synthetic string field */
/* Convenience field for getting a name from the contact.
Returns the first one of [File-As, Full Name, Org, Email1]
to be set */
E_CONTACT_REV, /* string field to hold time of last update to this vcard*/
E_CONTACT_NAME_OR_ORG,
/* Address fields */
E_CONTACT_ADDRESS, /* Multi-valued structured (EContactAddress) */
E_CONTACT_ADDRESS_HOME, /* synthetic structured field (EContactAddress) */
E_CONTACT_ADDRESS_WORK, /* synthetic structured field (EContactAddress) */
E_CONTACT_ADDRESS_OTHER, /* synthetic structured field (EContactAddress) */
E_CONTACT_CATEGORY_LIST, /* multi-valued */
/* Photo/Logo */
E_CONTACT_PHOTO, /* structured field (EContactPhoto) */
E_CONTACT_LOGO, /* structured field (EContactPhoto) */
E_CONTACT_NAME, /* structured field (EContactName) */
E_CONTACT_EMAIL, /* Multi-valued */
/* Instant Messaging fields */
E_CONTACT_IM_AIM, /* Multi-valued */
E_CONTACT_IM_GROUPWISE, /* Multi-valued */
E_CONTACT_IM_JABBER, /* Multi-valued */
E_CONTACT_IM_YAHOO, /* Multi-valued */
E_CONTACT_IM_MSN, /* Multi-valued */
E_CONTACT_IM_ICQ, /* Multi-valued */
E_CONTACT_WANTS_HTML, /* boolean field */
/* fields used for describing contact lists. a contact list
is just a contact with _IS_LIST set to true. the members
are listed in the _EMAIL field. */
E_CONTACT_IS_LIST, /* boolean field */
E_CONTACT_LIST_SHOW_ADDRESSES, /* boolean field */
E_CONTACT_BIRTH_DATE, /* structured field (EContactDate) */
E_CONTACT_ANNIVERSARY, /* structured field (EContactDate) */
/* Security Fields */
E_CONTACT_X509_CERT, /* structured field (EContactCert) */
E_CONTACT_IM_GADUGADU_HOME_1, /* Synthetic string field */
E_CONTACT_IM_GADUGADU_HOME_2, /* Synthetic string field */
E_CONTACT_IM_GADUGADU_HOME_3, /* Synthetic string field */
E_CONTACT_IM_GADUGADU_WORK_1, /* Synthetic string field */
E_CONTACT_IM_GADUGADU_WORK_2, /* Synthetic string field */
E_CONTACT_IM_GADUGADU_WORK_3, /* Synthetic string field */
E_CONTACT_IM_GADUGADU, /* Multi-valued */
E_CONTACT_GEO, /* structured field (EContactGeo) */
E_CONTACT_TEL,
E_CONTACT_SIP,
E_CONTACT_IM_SKYPE_HOME_1, /* Synthetic string field */
E_CONTACT_IM_SKYPE_HOME_2, /* Synthetic string field */
E_CONTACT_IM_SKYPE_HOME_3, /* Synthetic string field */
E_CONTACT_IM_SKYPE_WORK_1, /* Synthetic string field */
E_CONTACT_IM_SKYPE_WORK_2, /* Synthetic string field */
E_CONTACT_IM_SKYPE_WORK_3, /* Synthetic string field */
E_CONTACT_IM_SKYPE, /* Multi-valued */
E_CONTACT_FIELD_LAST,
E_CONTACT_FIELD_FIRST = E_CONTACT_UID,
/* useful constants */
E_CONTACT_LAST_SIMPLE_STRING = E_CONTACT_NAME_OR_ORG,
E_CONTACT_FIRST_PHONE_ID = E_CONTACT_PHONE_ASSISTANT,
E_CONTACT_LAST_PHONE_ID = E_CONTACT_PHONE_TTYTDD,
E_CONTACT_FIRST_EMAIL_ID = E_CONTACT_EMAIL_1,
E_CONTACT_LAST_EMAIL_ID = E_CONTACT_EMAIL_4,
E_CONTACT_FIRST_ADDRESS_ID = E_CONTACT_ADDRESS_HOME,
E_CONTACT_LAST_ADDRESS_ID = E_CONTACT_ADDRESS_OTHER,
E_CONTACT_FIRST_LABEL_ID = E_CONTACT_ADDRESS_LABEL_HOME,
E_CONTACT_LAST_LABEL_ID = E_CONTACT_ADDRESS_LABEL_OTHER
} EContactField;
typedef struct {
double latitude;
double longitude;
} EContactGeo;
A pair of geographic coordinates.
double latitude; |
the latitude, in decimal degrees |
double longitude; |
the longitude, in decimal degrees |
typedef struct {
char *family;
char *given;
char *additional;
char *prefixes;
char *suffixes;
} EContactName;
A structured name field, related to the vCard "N" field.
char *family; |
family name/surname/last name |
char *given; |
given name/first name |
char *additional; |
middle name(s) |
char *prefixes; |
honorific prefixes (e.g., "Mr.", "Ms.", "Dr.") |
char *suffixes; |
honorific suffixes (e.g., "M.D.", "Ph.D.") |
typedef struct {
EContactPhotoType type;
union {
struct {
char *mime_type;
gsize length;
guchar *data;
} inlined;
char *uri;
} data;
} EContactPhoto;
A structured representation of the contact's PHOTO vCard field.
The type determines whether an instance contains data.inlined OR data.uri.
The data.inlined.mime_type is the MIME type of the photo data. The
data.inlined.length is the length of the photo data. The data.inlined.data
is the photo's data, as encoded by data.inlined.mime_type.
EContactPhotoType type; |
the EContactPhotoType |
char *uri; |
the URI for a non-inlined photo file (if type =
E_CONTACT_PHOTO_TYPE_URI)
|
typedef enum {
E_CONTACT_PHOTO_TYPE_INLINED,
E_CONTACT_PHOTO_TYPE_URI
} EContactPhotoType;
The storage scheme for the contact's PHOTO fields.
EContact* e_contact_new (void);
Creates a new, blank EContact.
| Returns : | A new EContact. |
EContact* e_contact_new_from_vcard (const char *vcard);
Creates a new EContact based on a vcard.
vcard : |
a string representing a vcard |
| Returns : | A new EContact. |
EContact* e_contact_duplicate (EContact *contact);
Creates a copy of contact.
gpointer e_contact_get (EContact *contact, EContactField field_id);
Gets the value of contact's field specified by field_id.
contact : |
an EContact |
field_id : |
an EContactField |
| Returns : | Depends on the field's type, owned by the caller. |
gconstpointer e_contact_get_const (EContact *contact, EContactField field_id);
Gets the value of contact's field specified by field_id, caching
the result so it can be freed later.
contact : |
an EContact |
field_id : |
an EContactField |
| Returns : | Depends on the field's type, owned by the EContact. |
void e_contact_set (EContact *contact, EContactField field_id, const gpointer value);
Sets the value of contact's field specified by field_id to value.
contact : |
an EContact |
field_id : |
an EContactField |
value : |
a value whose type depends on the field_id
|
EContactDate* e_contact_date_new (void);
Creates a new EContactDate struct.
| Returns : | A new EContactDate struct. |
EContactDate* e_contact_date_from_string (const char *str);
Creates a new EContactDate based on str.
str : |
a date string in the format YYYY-MM-DD or YYYYMMDD |
| Returns : | A new EContactDate struct. |
char* e_contact_date_to_string (EContactDate *dt);
Generates a date string in the format YYYY-MM-DD based
on the values of dt.
dt : |
an EContactDate |
| Returns : | A date string, owned by the caller. |
gboolean e_contact_date_equal (EContactDate *dt1, EContactDate *dt2);
Checks if dt1 and dt2 are the same date.
dt1 : |
an EContactDate |
dt2 : |
an EContactDate |
| Returns : | TRUE if dt1 and dt2 are equal, FALSE otherwise.
|
EContactName* e_contact_name_new (void);
Creates a new EContactName struct.
| Returns : | A new EContactName struct. |
char* e_contact_name_to_string (const EContactName *name);
Generates a string representation of name.
name : |
an EContactName |
| Returns : | The string representation of name.
|
EContactName* e_contact_name_from_string (const char *name_str);
Creates a new EContactName based on the parsed name_str.
name_str : |
a string representing a contact's full name |
| Returns : | A new EContactName struct. |
EContactName* e_contact_name_copy (EContactName *n);
Creates a copy of n.
n : |
an EContactName |
| Returns : | A new EContactName identical to n.
|
void e_contact_date_free (EContactDate *date);
Frees the date struct and its contents.
date : |
an EContactDate |
void e_contact_name_free (EContactName *name);
Frees name and its contents.
name : |
an EContactName |
void e_contact_photo_free (EContactPhoto *photo);
Frees the photo struct and its contents.
photo : |
an EContactPhoto struct |
void e_contact_address_free (EContactAddress *address);
Frees the address struct and its contents.
address : |
an EContactAddress |
const char* e_contact_field_name (EContactField field_id);
Gets the string representation of field_id.
field_id : |
an EContactField |
| Returns : | The string representation of field_id, or NULL if it doesn't exist.
|
const char* e_contact_pretty_name (EContactField field_id);
Gets a human-readable, translated string representation
of field_id.
field_id : |
an EContactField |
| Returns : | The human-readable representation of field_id, or NULL if it doesn't exist.
|
EContactField e_contact_field_id (const char *field_name);
Gets the EContactField corresponding to the field_name.
field_name : |
a string representing a contact field |
| Returns : | An EContactField corresponding to field_name, or 0 if it doesn't exist.
|
void e_contact_cert_free (EContactCert *cert);
Frees the cert struct and its contents.
cert : |
an EContactCert |
EContactField e_contact_field_id_from_vcard (const char *vcard_field);
Gets the EContactField corresponding to the vCard field name in
vcard_field.
vcard_field : |
a string representing a contact field |
| Returns : | An EContactField corresponding to vcard_field, or 0 if it
doesn't exist.
|
void e_contact_geo_free (EContactGeo *geo);
Frees the geo struct and its contents.
geo : |
an EContactGeo |
GList* e_contact_get_attributes (EContact *contact, EContactField field_id);
Gets a list of the vcard attributes for contact's field_id.
contact : |
an EContact |
field_id : |
an EContactField |
| Returns : | A GList of pointers to EVCardAttribute, owned by the caller. |
gboolean e_contact_inline_data (EContact *contact);
Inlines the locally referred data, currently only works with EContactPhoto (E_CONTACT_PHOTO and E_CONTACT_LOGO)
contact : |
an EContact |
| Returns : | TRUE if the contact is changed during the operation, FASLE
otherwise.
|
gboolean e_contact_is_syncable (EContact *contact);
Retrieves whether a contact should be included in the synchronisation process.
contact : |
an Econtact |
| Returns : | TRUE if a contact should be included in the synchronisation
process
|
gboolean e_contact_persist_data (EContact *contact, const char *dir);
Persist the inlined data from contact in dir. Creates dir if it does not
exists.
contact : |
an EContact |
dir : |
the directory where the inlined data should be saved. |
| Returns : | TRUE if the contact is changed during the operation, FALSE
otherwise.
|
void e_contact_set_attributes (EContact *contact, EContactField field_id, GList *attributes);
Sets the vcard attributes for contact's field_id.
contact : |
an EContact |
field_id : |
an EContactField |
attributes : |
a GList of pointers to EVCardAttribute |
const char* e_contact_vcard_attribute (EContactField field_id);
Gets the vcard attribute corresponding to field_id, as a string.
field_id : |
an EContactField |
| Returns : | The vcard attribute corresponding to field_id, or NULL if it doesn't exist.
|
"address-label-home" property"address-label-home" gchar* : Read / Write
Home Address Label.
Default value: NULL
"address-label-other" property"address-label-other" gchar* : Read / Write
Other Address Label.
Default value: NULL
"address-label-work" property"address-label-work" gchar* : Read / Write
Work Address Label.
Default value: NULL
"assistant-phone" property"assistant-phone" gchar* : Read / Write
Assistant Phone.
Default value: NULL
"business-phone" property"business-phone" gchar* : Read / Write
Business Phone.
Default value: NULL
"business-phone-2" property"business-phone-2" gchar* : Read / Write
Business Phone 2.
Default value: NULL
"callback-phone" property"callback-phone" gchar* : Read / Write
Callback Phone.
Default value: NULL
"company-phone" property"company-phone" gchar* : Read / Write
Company Phone.
Default value: NULL
"im-aim-home-1" property"im-aim-home-1" gchar* : Read / Write
AIM Home Screen Name 1.
Default value: NULL
"im-aim-home-2" property"im-aim-home-2" gchar* : Read / Write
AIM Home Screen Name 2.
Default value: NULL
"im-aim-home-3" property"im-aim-home-3" gchar* : Read / Write
AIM Home Screen Name 3.
Default value: NULL
"im-aim-work-1" property"im-aim-work-1" gchar* : Read / Write
AIM Work Screen Name 1.
Default value: NULL
"im-aim-work-2" property"im-aim-work-2" gchar* : Read / Write
AIM Work Screen Name 2.
Default value: NULL
"im-aim-work-3" property"im-aim-work-3" gchar* : Read / Write
AIM Work Screen Name 3.
Default value: NULL
"im-gadugadu-home-1" property"im-gadugadu-home-1" gchar* : Read / Write
Gadu-Gadu Home Id 1.
Default value: NULL
"im-gadugadu-home-2" property"im-gadugadu-home-2" gchar* : Read / Write
Gadu-Gadu Home Id 2.
Default value: NULL
"im-gadugadu-home-3" property"im-gadugadu-home-3" gchar* : Read / Write
Gadu-Gadu Home Id 3.
Default value: NULL
"im-gadugadu-work-1" property"im-gadugadu-work-1" gchar* : Read / Write
Gadu-Gadu Work Id 1.
Default value: NULL
"im-gadugadu-work-2" property"im-gadugadu-work-2" gchar* : Read / Write
Gadu-Gadu Work Id 2.
Default value: NULL
"im-gadugadu-work-3" property"im-gadugadu-work-3" gchar* : Read / Write
Gadu-Gadu Work Id 3.
Default value: NULL
"im-groupwise-home-1" property"im-groupwise-home-1" gchar* : Read / Write
GroupWise Home Screen Name 1.
Default value: NULL
"im-groupwise-home-2" property"im-groupwise-home-2" gchar* : Read / Write
GroupWise Home Screen Name 2.
Default value: NULL
"im-groupwise-home-3" property"im-groupwise-home-3" gchar* : Read / Write
GroupWise Home Screen Name 3.
Default value: NULL
"im-groupwise-work-1" property"im-groupwise-work-1" gchar* : Read / Write
GroupWise Work Screen Name 1.
Default value: NULL
"im-groupwise-work-2" property"im-groupwise-work-2" gchar* : Read / Write
GroupWise Work Screen Name 2.
Default value: NULL
"im-groupwise-work-3" property"im-groupwise-work-3" gchar* : Read / Write
GroupWise Work Screen Name 3.
Default value: NULL
"im-icq-home-1" property"im-icq-home-1" gchar* : Read / Write
ICQ Home Id 1.
Default value: NULL
"im-icq-home-2" property"im-icq-home-2" gchar* : Read / Write
ICQ Home Id 2.
Default value: NULL
"im-icq-home-3" property"im-icq-home-3" gchar* : Read / Write
ICQ Home Id 3.
Default value: NULL
"im-icq-work-1" property"im-icq-work-1" gchar* : Read / Write
ICQ Work Id 1.
Default value: NULL
"im-icq-work-2" property"im-icq-work-2" gchar* : Read / Write
ICQ Work Id 2.
Default value: NULL
"im-icq-work-3" property"im-icq-work-3" gchar* : Read / Write
ICQ Work Id 3.
Default value: NULL
"im-jabber-home-1" property"im-jabber-home-1" gchar* : Read / Write
Jabber Home Id 1.
Default value: NULL
"im-jabber-home-2" property"im-jabber-home-2" gchar* : Read / Write
Jabber Home Id 2.
Default value: NULL
"im-jabber-home-3" property"im-jabber-home-3" gchar* : Read / Write
Jabber Home Id 3.
Default value: NULL
"im-jabber-work-1" property"im-jabber-work-1" gchar* : Read / Write
Jabber Work Id 1.
Default value: NULL
"im-jabber-work-2" property"im-jabber-work-2" gchar* : Read / Write
Jabber Work Id 3.
Default value: NULL
"im-jabber-work-3" property"im-jabber-work-3" gchar* : Read / Write
Jabber Work Id 2.
Default value: NULL
"im-msn-home-1" property"im-msn-home-1" gchar* : Read / Write
MSN Home Screen Name 1.
Default value: NULL
"im-msn-home-2" property"im-msn-home-2" gchar* : Read / Write
MSN Home Screen Name 2.
Default value: NULL
"im-msn-home-3" property"im-msn-home-3" gchar* : Read / Write
MSN Home Screen Name 3.
Default value: NULL
"im-msn-work-1" property"im-msn-work-1" gchar* : Read / Write
MSN Work Screen Name 1.
Default value: NULL
"im-msn-work-2" property"im-msn-work-2" gchar* : Read / Write
MSN Work Screen Name 2.
Default value: NULL
"im-msn-work-3" property"im-msn-work-3" gchar* : Read / Write
MSN Work Screen Name 3.
Default value: NULL
"im-skype-home-1" property"im-skype-home-1" gchar* : Read / Write
Skype Home Id 1.
Default value: NULL
"im-skype-home-2" property"im-skype-home-2" gchar* : Read / Write
Skype Home Id 2.
Default value: NULL
"im-skype-home-3" property"im-skype-home-3" gchar* : Read / Write
Skype Home Id 3.
Default value: NULL
"im-skype-work-1" property"im-skype-work-1" gchar* : Read / Write
Skype Work Id 1.
Default value: NULL
"im-skype-work-2" property"im-skype-work-2" gchar* : Read / Write
Skype Work Id 2.
Default value: NULL
"im-skype-work-3" property"im-skype-work-3" gchar* : Read / Write
Skype Work Id 3.
Default value: NULL
"im-yahoo-home-1" property"im-yahoo-home-1" gchar* : Read / Write
Yahoo! Home Screen Name 1.
Default value: NULL
"im-yahoo-home-2" property"im-yahoo-home-2" gchar* : Read / Write
Yahoo! Home Screen Name 2.
Default value: NULL
"im-yahoo-home-3" property"im-yahoo-home-3" gchar* : Read / Write
Yahoo! Home Screen Name 3.
Default value: NULL
"im-yahoo-work-1" property"im-yahoo-work-1" gchar* : Read / Write
Yahoo! Work Screen Name 1.
Default value: NULL
"im-yahoo-work-2" property"im-yahoo-work-2" gchar* : Read / Write
Yahoo! Work Screen Name 2.
Default value: NULL
"im-yahoo-work-3" property"im-yahoo-work-3" gchar* : Read / Write
Yahoo! Work Screen Name 3.
Default value: NULL
"list-show-addresses" property"list-show-addresses" gboolean : Read / Write
List Show Addresses.
Default value: FALSE
"primary-phone" property"primary-phone" gchar* : Read / Write
Primary Phone.
Default value: NULL
"video-url" property"video-url" gchar* : Read / Write
Video Conferencing URL.
Default value: NULL
"wants-html" property"wants-html" gboolean : Read / Write
Wants HTML Mail.
Default value: FALSE