Top | ![]() |
![]() |
![]() |
![]() |
EContact *
e_contact_new_from_vcard (const gchar *vcard
);
Creates a new EContact based on a vcard.
EContact * e_contact_new_from_vcard_with_uid (const gchar *vcard
,const gchar *uid
);
Creates a new EContact based on a vcard and a predefined UID.
Since 3.4
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
.
Depends on the field's type, owned by the caller. This may be NULL
if the field isn't set.
[transfer full][allow-none]
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.
void e_contact_set (EContact *contact
,EContactField field_id
,gconstpointer value
);
EContactDate *
e_contact_date_from_string (const gchar *str
);
Creates a new EContactDate based on str
.
gchar *
e_contact_date_to_string (EContactDate *dt
);
Generates a date string in the format YYYY-MM-DD based
on the values of dt
.
gboolean e_contact_date_equal (EContactDate *dt1
,EContactDate *dt2
);
Checks if dt1
and dt2
are the same date.
gchar *
e_contact_name_to_string (const EContactName *name
);
Generates a string representation of name
.
EContactName *
e_contact_name_from_string (const gchar *name_str
);
Creates a new EContactName based on the parsed name_str
.
void
e_contact_date_free (EContactDate *date
);
Frees the date
struct and its contents.
EContactPhoto *
e_contact_photo_new (void
);
Creates a new EContactPhoto struct.
Since 3.2
const guchar * e_contact_photo_get_inlined (EContactPhoto *photo
,gsize *len
);
Gets the photo
's data.
the inlined image in the
EContactPhoto, or NULL
if it has not been set.
[transfer none][array length=len][allow-none]
Since 3.2
void e_contact_photo_set_inlined (EContactPhoto *photo
,const guchar *data
,gsize len
);
Sets the photo
's inlined data.
photo |
||
data |
the inlined image data. |
[transfer none][array length=len] |
len |
the length of |
Since 3.2
const gchar *
e_contact_photo_get_mime_type (EContactPhoto *photo
);
Gets the photo
's mime type.
Since 3.2
void e_contact_photo_set_mime_type (EContactPhoto *photo
,const gchar *mime_type
);
Sets the photo
's mime type.
Since 3.2
const gchar *
e_contact_photo_get_uri (EContactPhoto *photo
);
Gets the photo
's URI.
Since 3.2
void e_contact_photo_set_uri (EContactPhoto *photo
,const gchar *uri
);
Sets the photo
's URI.
Since 3.2
gboolean e_contact_inline_local_photos (EContact *contact
,GError **error
);
Tries to modify any EContactPhoto fields which are
stored on the local file system as type E_CONTACT_PHOTO_TYPE_URI
to be inlined and stored as E_CONTACT_PHOTO_TYPE_INLINED
instead.
Since 3.4
void
e_contact_photo_free (EContactPhoto *photo
);
Frees the photo
struct and its contents.
void
e_contact_geo_free (EContactGeo *geo
);
Frees the geo
struct and its contents.
Since 1.12
EContactAddress *
e_contact_address_new (void
);
Creates a new EContactAddress struct.
Since 3.2
void
e_contact_address_free (EContactAddress *address
);
Frees the address
struct and its contents.
const gchar *
e_contact_field_name (EContactField field_id
);
Gets the string representation of field_id
.
const gchar *
e_contact_pretty_name (EContactField field_id
);
Gets a human-readable, translated string representation
of field_id
.
EContactField
e_contact_field_id (const gchar *field_name
);
Gets the EContactField corresponding to the field_name
.
EContactField
e_contact_field_id_from_vcard (const gchar *vcard_field
);
Gets the EContactField corresponding to the vcard_field
.
Since 2.26
void
e_contact_cert_free (EContactCert *cert
);
Frees the cert
struct and its contents.
GList * e_contact_get_attributes (EContact *contact
,EContactField field_id
);
Gets a list of the vcard attributes for contact
's field_id
.
A GList of pointers to EVCardAttribute, owned by the caller.
[transfer full][element-type EVCardAttribute]
void e_contact_set_attributes (EContact *contact
,EContactField field_id
,GList *attributes
);
Sets the vcard attributes for contact
's field_id
.
Attributes are added to the contact in the same order as they are in attributes
.
contact |
an EContact |
|
field_id |
||
attributes |
a GList of pointers to EVCardAttribute. |
[element-type EVCardAttribute] |
const gchar *
e_contact_vcard_attribute (EContactField field_id
);
Gets the vcard attribute corresponding to field_id
, as a string.
typedef struct { gchar *family; gchar *given; gchar *additional; gchar *prefixes; gchar *suffixes; } EContactName;
typedef struct { EContactPhotoType type; union { struct { gchar *mime_type; gsize length; guchar *data; } inlined; gchar *uri; } data; } EContactPhoto;
typedef struct { gchar *address_format; /* the two letter country code that * determines the format/meaning of the * following fields */ gchar *po; gchar *ext; gchar *street; gchar *locality; gchar *region; gchar *code; gchar *country; } EContactAddress;
“address-label-home”
property“address-label-home” gchar *
Home Address Label.
Flags: Read / Write
Default value: NULL
“address-label-other”
property“address-label-other” gchar *
Other Address Label.
Flags: Read / Write
Default value: NULL
“address-label-work”
property“address-label-work” gchar *
Work Address Label.
Flags: Read / Write
Default value: NULL
“assistant-phone”
property“assistant-phone” gchar *
Assistant Phone.
Flags: Read / Write
Default value: NULL
“business-fax”
property“business-fax” gchar *
Business Fax.
Flags: Read / Write
Default value: NULL
“business-phone”
property“business-phone” gchar *
Business Phone.
Flags: Read / Write
Default value: NULL
“business-phone-2”
property“business-phone-2” gchar *
Business Phone 2.
Flags: Read / Write
Default value: NULL
“callback-phone”
property“callback-phone” gchar *
Callback Phone.
Flags: Read / Write
Default value: NULL
“company-phone”
property“company-phone” gchar *
Company Phone.
Flags: Read / Write
Default value: NULL
“family-name”
property“family-name” gchar *
Family Name.
Flags: Read / Write
Default value: NULL
“home-phone-2”
property“home-phone-2” gchar *
Home Phone 2.
Flags: Read / Write
Default value: NULL
“homepage-url”
property“homepage-url” gchar *
Homepage URL.
Flags: Read / Write
Default value: NULL
“icscalendar”
property“icscalendar” gchar *
ICS Calendar.
Flags: Read / Write
Default value: NULL
“im-aim-home-1”
property“im-aim-home-1” gchar *
AIM Home Screen Name 1.
Flags: Read / Write
Default value: NULL
“im-aim-home-2”
property“im-aim-home-2” gchar *
AIM Home Screen Name 2.
Flags: Read / Write
Default value: NULL
“im-aim-home-3”
property“im-aim-home-3” gchar *
AIM Home Screen Name 3.
Flags: Read / Write
Default value: NULL
“im-aim-work-1”
property“im-aim-work-1” gchar *
AIM Work Screen Name 1.
Flags: Read / Write
Default value: NULL
“im-aim-work-2”
property“im-aim-work-2” gchar *
AIM Work Screen Name 2.
Flags: Read / Write
Default value: NULL
“im-aim-work-3”
property“im-aim-work-3” gchar *
AIM Work Screen Name 3.
Flags: Read / Write
Default value: NULL
“im-gadugadu-home-1”
property“im-gadugadu-home-1” gchar *
Gadu-Gadu Home ID 1.
Flags: Read / Write
Default value: NULL
“im-gadugadu-home-2”
property“im-gadugadu-home-2” gchar *
Gadu-Gadu Home ID 2.
Flags: Read / Write
Default value: NULL
“im-gadugadu-home-3”
property“im-gadugadu-home-3” gchar *
Gadu-Gadu Home ID 3.
Flags: Read / Write
Default value: NULL
“im-gadugadu-work-1”
property“im-gadugadu-work-1” gchar *
Gadu-Gadu Work ID 1.
Flags: Read / Write
Default value: NULL
“im-gadugadu-work-2”
property“im-gadugadu-work-2” gchar *
Gadu-Gadu Work ID 2.
Flags: Read / Write
Default value: NULL
“im-gadugadu-work-3”
property“im-gadugadu-work-3” gchar *
Gadu-Gadu Work ID 3.
Flags: Read / Write
Default value: NULL
“im-google-talk-home-1”
property“im-google-talk-home-1” gchar *
Google Talk Home Name 1.
Flags: Read / Write
Default value: NULL
“im-google-talk-home-2”
property“im-google-talk-home-2” gchar *
Google Talk Home Name 2.
Flags: Read / Write
Default value: NULL
“im-google-talk-home-3”
property“im-google-talk-home-3” gchar *
Google Talk Home Name 3.
Flags: Read / Write
Default value: NULL
“im-google-talk-work-1”
property“im-google-talk-work-1” gchar *
Google Talk Work Name 1.
Flags: Read / Write
Default value: NULL
“im-google-talk-work-2”
property“im-google-talk-work-2” gchar *
Google Talk Work Name 2.
Flags: Read / Write
Default value: NULL
“im-google-talk-work-3”
property“im-google-talk-work-3” gchar *
Google Talk Work Name 3.
Flags: Read / Write
Default value: NULL
“im-groupwise-home-1”
property“im-groupwise-home-1” gchar *
GroupWise Home Screen Name 1.
Flags: Read / Write
Default value: NULL
“im-groupwise-home-2”
property“im-groupwise-home-2” gchar *
GroupWise Home Screen Name 2.
Flags: Read / Write
Default value: NULL
“im-groupwise-home-3”
property“im-groupwise-home-3” gchar *
GroupWise Home Screen Name 3.
Flags: Read / Write
Default value: NULL
“im-groupwise-work-1”
property“im-groupwise-work-1” gchar *
GroupWise Work Screen Name 1.
Flags: Read / Write
Default value: NULL
“im-groupwise-work-2”
property“im-groupwise-work-2” gchar *
GroupWise Work Screen Name 2.
Flags: Read / Write
Default value: NULL
“im-groupwise-work-3”
property“im-groupwise-work-3” gchar *
GroupWise Work Screen Name 3.
Flags: Read / Write
Default value: NULL
“im-icq-home-1”
property“im-icq-home-1” gchar *
ICQ Home ID 1.
Flags: Read / Write
Default value: NULL
“im-icq-home-2”
property“im-icq-home-2” gchar *
ICQ Home ID 2.
Flags: Read / Write
Default value: NULL
“im-icq-home-3”
property“im-icq-home-3” gchar *
ICQ Home ID 3.
Flags: Read / Write
Default value: NULL
“im-icq-work-1”
property“im-icq-work-1” gchar *
ICQ Work ID 1.
Flags: Read / Write
Default value: NULL
“im-icq-work-2”
property“im-icq-work-2” gchar *
ICQ Work ID 2.
Flags: Read / Write
Default value: NULL
“im-icq-work-3”
property“im-icq-work-3” gchar *
ICQ Work ID 3.
Flags: Read / Write
Default value: NULL
“im-jabber-home-1”
property“im-jabber-home-1” gchar *
Jabber Home ID 1.
Flags: Read / Write
Default value: NULL
“im-jabber-home-2”
property“im-jabber-home-2” gchar *
Jabber Home ID 2.
Flags: Read / Write
Default value: NULL
“im-jabber-home-3”
property“im-jabber-home-3” gchar *
Jabber Home ID 3.
Flags: Read / Write
Default value: NULL
“im-jabber-work-1”
property“im-jabber-work-1” gchar *
Jabber Work ID 1.
Flags: Read / Write
Default value: NULL
“im-jabber-work-2”
property“im-jabber-work-2” gchar *
Jabber Work ID 3.
Flags: Read / Write
Default value: NULL
“im-jabber-work-3”
property“im-jabber-work-3” gchar *
Jabber Work ID 2.
Flags: Read / Write
Default value: NULL
“im-msn-home-1”
property“im-msn-home-1” gchar *
MSN Home Screen Name 1.
Flags: Read / Write
Default value: NULL
“im-msn-home-2”
property“im-msn-home-2” gchar *
MSN Home Screen Name 2.
Flags: Read / Write
Default value: NULL
“im-msn-home-3”
property“im-msn-home-3” gchar *
MSN Home Screen Name 3.
Flags: Read / Write
Default value: NULL
“im-msn-work-1”
property“im-msn-work-1” gchar *
MSN Work Screen Name 1.
Flags: Read / Write
Default value: NULL
“im-msn-work-2”
property“im-msn-work-2” gchar *
MSN Work Screen Name 2.
Flags: Read / Write
Default value: NULL
“im-msn-work-3”
property“im-msn-work-3” gchar *
MSN Work Screen Name 3.
Flags: Read / Write
Default value: NULL
“im-skype-home-1”
property“im-skype-home-1” gchar *
Skype Home Name 1.
Flags: Read / Write
Default value: NULL
“im-skype-home-2”
property“im-skype-home-2” gchar *
Skype Home Name 2.
Flags: Read / Write
Default value: NULL
“im-skype-home-3”
property“im-skype-home-3” gchar *
Skype Home Name 3.
Flags: Read / Write
Default value: NULL
“im-skype-work-1”
property“im-skype-work-1” gchar *
Skype Work Name 1.
Flags: Read / Write
Default value: NULL
“im-skype-work-2”
property“im-skype-work-2” gchar *
Skype Work Name 2.
Flags: Read / Write
Default value: NULL
“im-skype-work-3”
property“im-skype-work-3” gchar *
Skype Work Name 3.
Flags: Read / Write
Default value: NULL
“im-yahoo-home-1”
property“im-yahoo-home-1” gchar *
Yahoo! Home Screen Name 1.
Flags: Read / Write
Default value: NULL
“im-yahoo-home-2”
property“im-yahoo-home-2” gchar *
Yahoo! Home Screen Name 2.
Flags: Read / Write
Default value: NULL
“im-yahoo-home-3”
property“im-yahoo-home-3” gchar *
Yahoo! Home Screen Name 3.
Flags: Read / Write
Default value: NULL
“im-yahoo-work-1”
property“im-yahoo-work-1” gchar *
Yahoo! Work Screen Name 1.
Flags: Read / Write
Default value: NULL
“im-yahoo-work-2”
property“im-yahoo-work-2” gchar *
Yahoo! Work Screen Name 2.
Flags: Read / Write
Default value: NULL
“im-yahoo-work-3”
property“im-yahoo-work-3” gchar *
Yahoo! Work Screen Name 3.
Flags: Read / Write
Default value: NULL
“list-show-addresses”
property“list-show-addresses” gboolean
List Show Addresses.
Flags: Read / Write
Default value: FALSE
“mobile-phone”
property“mobile-phone” gchar *
Mobile Phone.
Flags: Read / Write
Default value: NULL
“org-unit”
property“org-unit” gchar *
Organizational Unit.
Flags: Read / Write
Default value: NULL
“other-phone”
property“other-phone” gchar *
Other Phone.
Flags: Read / Write
Default value: NULL
“primary-phone”
property“primary-phone” gchar *
Primary Phone.
Flags: Read / Write
Default value: NULL
“video-url”
property“video-url” gchar *
Video Conferencing URL.
Flags: Read / Write
Default value: NULL
“wants-html”
property“wants-html” gboolean
Wants HTML Mail.
Flags: Read / Write
Default value: FALSE