EBook.Destination
Description: Reference for EBook.Destination

### Class

# EBookDestination

#### Description

    class EBook.Destination : GObject.Object
    {
      EDestinationPrivate* priv
    }

No description available.

#### Hierarchy

#### Ancestors

- GObject

#### Constructors

###### e_destination_new

Creates a new `EDestination` with blank values.

#### Functions

###### e_destination_exportv

Exports multiple `EDestination` elements to a single XML document.

###### e_destination_freev

Unrefs the elements of `destv` and frees `destv` itself.

###### e_destination_get_textrepv

Generates a joint text representation of all the `EDestination` elements in `destv`.

###### e_destination_import

Creates an `EDestination` from an XML document.

###### e_destination_importv

Creates an array of pointers to `EDestination` elements from an XML document.

#### Instance methods

###### e_destination_copy

Creates a new `EDestination` identical to `dest`.

###### e_destination_empty

Checks if `dest` is blank.

###### e_destination_equal

Checks if `a` and `b` are equal.

###### e_destination_export

Exports a destination to an XML document.

###### e_destination_export_to_vcard_attribute

Exports the contact information from `dest` to parameters and values in `attr`, suitable for an address book.

###### e_destination_get_address

Gets the encoded name and email address, or in the case of lists, the encoded list of email addresses, from `dest`. The returned string is suitable for use in an email header, but not for displaying to users.

###### e_destination_get_contact

Gets the contact `dest` is pointing to, if any.

###### e_destination_get_contact_uid

Gets the unique contact ID `dest` is pointing to, if any.

###### e_destination_get_email

Gets the e-mail address of `dest`‘s addressee.

###### e_destination_get_email_num

Gets the index of the e-mail address of the contact that `dest` is pointing to, if any.

###### e_destination_get_html_mail_pref

Check if `dest` wants to get mail formatted as HTML.

###### e_destination_get_name

Gets the full name of `dest`‘s addressee, or if the addressee is a contact list, the name the list was filed under. The name can be encoded in quoted printable.

###### e_destination_get_source_uid

Gets the unique source ID `dest` is pointing to, if any. The source ID specifies which address book `dest`‘s contact came from.

###### e_destination_get_textrep

Generates a textual representation of `dest`, suitable for referring to the destination during user interaction. The name can be encoded in quoted printable.

###### e_destination_is_auto_recipient

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.

###### e_destination_is_evolution_list

Checks if `dest` is a list of addresses.

###### e_destination_is_ignored

Check if `dest` is to be ignored.

###### e_destination_list_get_dests

If `dest` is a list, gets recursively list of all destinations. Everything returned from this function belongs to `dest` and thus should not be freed.

since: 3.2

###### e_destination_list_get_root_dests

If `dest` is a list, gets the list of EDestinations assigned directly to `dest`. The list and its elements belong to `dest`, and should not be freed.

since: 3.2

###### e_destination_list_show_addresses

If `dest` is a list, checks if the addresses in the list should be presented to the user during interaction.

###### e_destination_set_auto_recipient

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.

###### e_destination_set_client

Specify the source `dest`‘s contact comes from. This is useful if you need to update the contact later.

since: 3.2

###### e_destination_set_contact

Sets `dest` to point to one of `contact`‘s e-mail addresses indicated by `email_num`.

###### e_destination_set_contact_uid

Sets `dest` to point to one of the contact specified by `uid`‘s e-mail addresses indicated by `email_num`.

###### e_destination_set_email

Sets the e-mail address of `dest`‘s addressee.

###### e_destination_set_html_mail_pref

Specifies whether `dest` wants to get mail formatted as HTML.

###### e_destination_set_ignored

Set the ignore flag on an `EDestination`.

###### e_destination_set_name

Sets the full name of `dest`‘s addressee.

###### e_destination_set_raw

Sets `dest` to point to the name and e-mail address resulting from parsing the supplied string. Useful for user input.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

#### Signals

###### EBook.Destination::changed

No description available.

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.

#### Class structure

    struct EBookDestinationClass {
      GObjectClass parent_class;
      void (* changed) (
        EDestination* destination
      );
      void (* _ebook_reserved1) (
    void
      );
      void (* _ebook_reserved2) (
    void
      );
      void (* _ebook_reserved3) (
    void
      );
      void (* _ebook_reserved4) (
    void
      );

    }

No description available.

###### Class members

`parent_class: GObjectClass`

  No description available.

`changed: void (* changed) ( EDestination* destination )`

  No description available.

`_ebook_reserved1: void (* _ebook_reserved1) ( void )`

  No description available.

`_ebook_reserved2: void (* _ebook_reserved2) ( void )`

  No description available.

`_ebook_reserved3: void (* _ebook_reserved3) ( void )`

  No description available.

`_ebook_reserved4: void (* _ebook_reserved4) ( void )`

  No description available.

#### Virtual methods

###### EBook.DestinationClass.changed

No description available.