|  |  |  | Evolution API Reference: libebook, the Addressbook Library |  | 
|---|---|---|---|---|
                    EDestination;
EDestination*       e_destination_copy                  (const EDestination *dest);
gboolean            e_destination_empty                 (const EDestination *dest);
gboolean            e_destination_equal                 (const EDestination *a,
                                                         const EDestination *b);
char*               e_destination_export                (const EDestination *dest);
void                e_destination_export_to_vcard_attribute
                                                        (EDestination *dest,
                                                         EVCardAttribute *attr);
char*               e_destination_exportv               (EDestination **destv);
void                e_destination_freev                 (EDestination **destv);
const char*         e_destination_get_address           (const EDestination *dest);
EContact*           e_destination_get_contact           (const EDestination *dest);
const char*         e_destination_get_contact_uid       (const EDestination *dest);
const char*         e_destination_get_email             (const EDestination *dest);
int                 e_destination_get_email_num         (const EDestination *dest);
gboolean            e_destination_get_html_mail_pref    (const EDestination *dest);
const char*         e_destination_get_name              (const EDestination *dest);
const char*         e_destination_get_source_uid        (const EDestination *dest);
const char*         e_destination_get_textrep           (const EDestination *dest,
                                                         gboolean include_email);
char*               e_destination_get_textrepv          (EDestination **destv);
EDestination*       e_destination_import                (const char *str);
EDestination**      e_destination_importv               (const char *str);
gboolean            e_destination_is_auto_recipient     (const EDestination *dest);
gboolean            e_destination_is_evolution_list     (const EDestination *dest);
gboolean            e_destination_is_ignored            (const EDestination *dest);
const GList*        e_destination_list_get_dests        (const EDestination *dest);
gboolean            e_destination_list_show_addresses   (const EDestination *dest);
EDestination*       e_destination_new                   (void);
void                e_destination_set_auto_recipient    (EDestination *dest,
                                                         gboolean value);
void                e_destination_set_book              (EDestination *dest,
                                                         EBook *book);
void                e_destination_set_contact           (EDestination *dest,
                                                         EContact *contact,
                                                         int email_num);
void                e_destination_set_contact_uid       (EDestination *dest,
                                                         const char *uid,
                                                         gint email_num);
void                e_destination_set_email             (EDestination *dest,
                                                         const char *email);
void                e_destination_set_html_mail_pref    (EDestination *dest,
                                                         gboolean flag);
void                e_destination_set_ignored           (EDestination *dest,
                                                         gboolean ignored);
void                e_destination_set_name              (EDestination *dest,
                                                         const char *name);
void                e_destination_set_raw               (EDestination *dest,
                                                         const char *raw);
EDestination* e_destination_copy (const EDestination *dest);
Creates a new EDestination identical to dest.
| dest: | an EDestination | 
| Returns : | A newly created EDestination, identical to dest. | 
gboolean e_destination_empty (const EDestination *dest);
Checks if dest is blank.
| dest: | an EDestination | 
| Returns : | TRUEifdestis empty,FALSEotherwise. | 
gboolean e_destination_equal (const EDestination *a, const EDestination *b);
Checks if a and b are equal.
| a: | an EDestination | 
| b: | an EDestination | 
| Returns : | TRUEif the destinations are equal,FALSEotherwise. | 
char* e_destination_export (const EDestination *dest);
Exports a destination to an XML document.
| dest: | an EDestination | 
| Returns : | An XML string, allocated with g_malloc. | 
void                e_destination_export_to_vcard_attribute
                                                        (EDestination *dest,
                                                         EVCardAttribute *attr);
Exports the contact information from dest to parameters
and values in attr, suitable for an address book.
| dest: | an EDestination | 
| attr: | an EVCardAttribute | 
char* e_destination_exportv (EDestination **destv);
Exports multiple EDestination elements to a single XML document.
| destv: | a NULL-terminated array of pointers to EDestination | 
| Returns : | An XML string, allocated with g_malloc. | 
void e_destination_freev (EDestination **destv);
Unrefs the elements of destv and frees destv itself.
| destv: | a NULL-terminated array of pointers to EDestination | 
const char* e_destination_get_address (const EDestination *dest);
Gets the formatted name and e-mail address, or in the case of
lists, the formatted list of e-mail addresses, from dest.
| dest: | an EDestination | 
| Returns : | A formatted destination string, or NULLif the destination was empty. | 
EContact* e_destination_get_contact (const EDestination *dest);
Gets the contact dest is pointing to, if any.
| dest: | an EDestination | 
| Returns : | An EContact, or NULLif none was set. | 
const char* e_destination_get_contact_uid (const EDestination *dest);
Gets the unique contact ID dest is pointing to, if any.
| dest: | an EDestination | 
| Returns : | A unique contact ID, or NULLif none was set. | 
const char* e_destination_get_email (const EDestination *dest);
Gets the e-mail address of dest's addressee.
| dest: | an EDestination | 
| Returns : | An e-mail address, or an empty string if none was set. | 
int e_destination_get_email_num (const EDestination *dest);
Gets the index of the e-mail address of the contact that
dest is pointing to, if any.
| dest: | an EDestination | 
| Returns : | The e-mail index, or -1 if none was set. | 
gboolean e_destination_get_html_mail_pref (const EDestination *dest);
Check if dest wants to get mail formatted as HTML.
| dest: | an EDestination | 
| Returns : | TRUEif destination wants HTML,FALSEif not. | 
const char* e_destination_get_name (const EDestination *dest);
Gets the full name of dest's addressee, or if the addressee is
a contact list, the name the list was filed under.
| dest: | an EDestination | 
| Returns : | The full name of the addressee, or NULLif none was set. | 
const char* e_destination_get_source_uid (const EDestination *dest);
Gets the unique source ID dest is pointing to, if any. The source
ID specifies which address book dest's contact came from.
| dest: | an EDestination | 
| Returns : | A unique source ID, or NULLif none was set. | 
const char* e_destination_get_textrep (const EDestination *dest, gboolean include_email);
Generates a textual representation of dest, suitable for referring
to the destination during user interaction.
| dest: | an EDestination | 
| include_email: | whether to include the e-mail address | 
| Returns : | A textual representation of the destination. | 
char* e_destination_get_textrepv (EDestination **destv);
Generates a joint text representation of all the EDestination
elements in destv.
| destv: | NULL-terminated array of pointers to EDestination | 
| Returns : | The text representation of destv. | 
EDestination* e_destination_import (const char *str);
Creates an EDestination from an XML document.
| str: | an XML string | 
| Returns : | An EDestination, or NULLif the document was not well-formed. | 
EDestination** e_destination_importv (const char *str);
Creates an array of pointers to EDestination elements from an XML document.
| str: | an XML string | 
| Returns : | A NULL-terminated array of pointers to EDestination elements. | 
gboolean e_destination_is_auto_recipient (const EDestination *dest);
Checks if dest is flagged as an automatic recipient, meaning
it was not explicitly specified by the user. This can be used
to hide it from some UI elements.
| dest: | an EDestination | 
| Returns : | TRUEif destination is an auto recipient,FALSEotherwise. | 
gboolean e_destination_is_evolution_list (const EDestination *dest);
Checks if dest is a list of addresses.
| dest: | an EDestination | 
| Returns : | TRUEif destination is a list,FALSEif it is an individual. | 
gboolean e_destination_is_ignored (const EDestination *dest);
Check if dest is to be ignored.
| dest: | an EDestination | 
| Returns : | TRUE if this destination should be ignored, else FALSE. | 
const GList* e_destination_list_get_dests (const EDestination *dest);
If dest is a list, gets the list of destinations. The list
and its elements belong to dest, and should not be freed.
| dest: | an EDestination | 
| Returns : | A list of elements of type EDestination, or NULL. | 
gboolean e_destination_list_show_addresses (const EDestination *dest);
If dest is a list, checks if the addresses in the list
should be presented to the user during interaction.
| dest: | an EDestination | 
| Returns : | TRUEif addresses should be shown,FALSEotherwise. | 
EDestination* e_destination_new (void);
Creates a new EDestination with blank values.
| Returns : | A newly created EDestination. | 
void e_destination_set_auto_recipient (EDestination *dest, gboolean value);
Sets the flag indicating if dest is an automatic recipient, meaning
it was not explicitly specified by the user. This can be used
to hide it from some UI elements.
| dest: | an EDestination | 
| value: | the auto recipient flag | 
void e_destination_set_book (EDestination *dest, EBook *book);
Specify the source dest's contact comes from. This is useful
if you need to update the contact later.
| dest: | an EDestination | 
| book: | an EBook | 
void e_destination_set_contact (EDestination *dest, EContact *contact, int email_num);
Sets dest to point to one of contact's e-mail addresses
indicated by email_num.
| dest: | an EDestination | 
| contact: | an EContact | 
| email_num: | an email index | 
void e_destination_set_contact_uid (EDestination *dest, const char *uid, gint email_num);
Sets dest to point to one of the contact specified by uid's e-mail
addresses indicated by email_num.
| dest: | an EDestination | 
| uid: | a unique contact ID | 
| email_num: | an email index | 
void e_destination_set_email (EDestination *dest, const char *email);
Sets the e-mail address of dest's addressee.
| dest: | an EDestination | 
| email: | the destination's e-mail address | 
void e_destination_set_html_mail_pref (EDestination *dest, gboolean flag);
Specifies whether dest wants to get mail formatted as HTML.
| dest: | an EDestination | 
| flag: | whether the destination wants HTML mail | 
void e_destination_set_ignored (EDestination *dest, gboolean ignored);
Set the ignore flag on a EDestination.
| dest: | an EDestination | 
| ignored: | TRUE if this EDestination should be ignored. | 
void e_destination_set_name (EDestination *dest, const char *name);
Sets the full name of dest's addressee.
| dest: | an EDestination | 
| name: | the destination's full name | 
void e_destination_set_raw (EDestination *dest, const char *raw);
Sets dest to point to the name and e-mail address resulting from
parsing the supplied string. Useful for user input.
| dest: | an EDestination | 
| raw: | an unparsed string | 
"changed" signalvoid user_function (EDestination *edestination, gpointer user_data) : Run Last
| edestination: | the object which received the signal. | 
| user_data: | user data set when the signal handler was connected. |