## GDataGDEmailAddress GDataGDEmailAddress — GData e-mail address element |

## Stability Level

Unstable, unless otherwise indicated

## Synopsis

    #include <gdata/gd/gdata-gd-email-address.h>

    #define             GDATA_GD_EMAIL_ADDRESS_HOME
    #define             GDATA_GD_EMAIL_ADDRESS_OTHER
    #define             GDATA_GD_EMAIL_ADDRESS_WORK
                        GDataGDEmailAddress;
                        GDataGDEmailAddressClass;
    GDataGDEmailAddress * gdata_gd_email_address_new        (const gchar *address,
                                                             const gchar *relation_type,
                                                             const gchar *label,
                                                             gboolean is_primary);
    const gchar *       gdata_gd_email_address_get_address  (GDataGDEmailAddress *self);
    void                gdata_gd_email_address_set_address  (GDataGDEmailAddress *self,
                                                             const gchar *address);
    const gchar *       gdata_gd_email_address_get_relation_type
                                                            (GDataGDEmailAddress *self);
    void                gdata_gd_email_address_set_relation_type
                                                            (GDataGDEmailAddress *self,
                                                             const gchar *relation_type);
    const gchar *       gdata_gd_email_address_get_label    (GDataGDEmailAddress *self);
    void                gdata_gd_email_address_set_label    (GDataGDEmailAddress *self,
                                                             const gchar *label);
    gboolean            gdata_gd_email_address_is_primary   (GDataGDEmailAddress *self);
    void                gdata_gd_email_address_set_is_primary
                                                            (GDataGDEmailAddress *self,
                                                             gboolean is_primary);
    const gchar *       gdata_gd_email_address_get_display_name
                                                            (GDataGDEmailAddress *self);
    void                gdata_gd_email_address_set_display_name
                                                            (GDataGDEmailAddress *self,
                                                             const gchar *display_name);

## Object Hierarchy

      GObject
       +----GDataParsable
             +----GDataGDEmailAddress

## Implemented Interfaces

GDataGDEmailAddress implements GDataComparable.

## Properties

      "address"                  gchar*                : Read / Write
      "display-name"             gchar*                : Read / Write
      "is-primary"               gboolean              : Read / Write
      "label"                    gchar*                : Read / Write
      "relation-type"            gchar*                : Read / Write

## Description

GDataGDEmailAddress represents an "email" element from the GData specification.

## Details

### GDATA_GD_EMAIL_ADDRESS_HOME

    #define GDATA_GD_EMAIL_ADDRESS_HOME "http://schemas.google.com/g/2005#home"

The relation type URI for a home e-mail address.

Since 0.7.0

### GDATA_GD_EMAIL_ADDRESS_OTHER

    #define GDATA_GD_EMAIL_ADDRESS_OTHER "http://schemas.google.com/g/2005#other"

The relation type URI for a miscellaneous e-mail address.

Since 0.7.0

### GDATA_GD_EMAIL_ADDRESS_WORK

    #define GDATA_GD_EMAIL_ADDRESS_WORK "http://schemas.google.com/g/2005#work"

The relation type URI for a work e-mail address.

Since 0.7.0

### GDataGDEmailAddress

    typedef struct _GDataGDEmailAddress GDataGDEmailAddress;

All the fields in the GDataGDEmailAddress structure are private and should never be accessed directly.

Since 0.2.0

### GDataGDEmailAddressClass

    typedef struct {
    } GDataGDEmailAddressClass;

All the fields in the GDataGDEmailAddressClass structure are private and should never be accessed directly.

Since 0.4.0

### gdata_gd_email_address_new ()

    GDataGDEmailAddress * gdata_gd_email_address_new        (const gchar *address,
                                                             const gchar *relation_type,
                                                             const gchar *label,
                                                             gboolean is_primary);

Creates a new GDataGDEmailAddress. More information is available in the GData specification.

`address` : | the e-mail address
`relation_type` : | the relationship between the e-mail address and its owner, or `NULL`. [allow-none]
`label` : | a human-readable label for the e-mail address, or `NULL`. [allow-none]
`is_primary` : | `TRUE` if this e-mail address is its owner's primary address, `FALSE` otherwise
Returns : | a new GDataGDEmailAddress, or `NULL`; unref with `g_object_unref()`

Since 0.2.0

### gdata_gd_email_address_get_address ()

    const gchar *       gdata_gd_email_address_get_address  (GDataGDEmailAddress *self);

Gets the "address" property.

`self` : | a GDataGDEmailAddress
Returns : | the e-mail address itself, or `NULL`

Since 0.4.0

### gdata_gd_email_address_set_address ()

    void                gdata_gd_email_address_set_address  (GDataGDEmailAddress *self,
                                                             const gchar *address);

Sets the "address" property to `address`.

`self` : | a GDataGDEmailAddress
`address` : | the new e-mail address

Since 0.4.0

### gdata_gd_email_address_get_relation_type ()

    const gchar *       gdata_gd_email_address_get_relation_type
                                                            (GDataGDEmailAddress *self);

Gets the "relation-type" property.

`self` : | a GDataGDEmailAddress
Returns : | the e-mail address' relation type, or `NULL`

Since 0.4.0

### gdata_gd_email_address_set_relation_type ()

    void                gdata_gd_email_address_set_relation_type
                                                            (GDataGDEmailAddress *self,
                                                             const gchar *relation_type);

Sets the "relation-type" property to `relation_type`.

Set `relation_type` to `NULL` to unset the property in the e-mail address.

`self` : | a GDataGDEmailAddress
`relation_type` : | the new relation type for the email_address, or `NULL`. [allow-none]

Since 0.4.0

### gdata_gd_email_address_get_label ()

    const gchar *       gdata_gd_email_address_get_label    (GDataGDEmailAddress *self);

Gets the "label" property.

`self` : | a GDataGDEmailAddress
Returns : | the e-mail address' label, or `NULL`

Since 0.4.0

### gdata_gd_email_address_set_label ()

    void                gdata_gd_email_address_set_label    (GDataGDEmailAddress *self,
                                                             const gchar *label);

Sets the "label" property to `label`.

Set `label` to `NULL` to unset the property in the e-mail address.

`self` : | a GDataGDEmailAddress
`label` : | the new label for the e-mail address, or `NULL`. [allow-none]

Since 0.4.0

### gdata_gd_email_address_is_primary ()

    gboolean            gdata_gd_email_address_is_primary   (GDataGDEmailAddress *self);

Gets the "is-primary" property.

`self` : | a GDataGDEmailAddress
Returns : | `TRUE` if this is the primary e-mail address, `FALSE` otherwise

Since 0.4.0

### gdata_gd_email_address_set_is_primary ()

    void                gdata_gd_email_address_set_is_primary
                                                            (GDataGDEmailAddress *self,
                                                             gboolean is_primary);

Sets the "is-primary" property to `is_primary`.

`self` : | a GDataGDEmailAddress
`is_primary` : | `TRUE` if this is the primary e-mail address, `FALSE` otherwise

Since 0.4.0

### gdata_gd_email_address_get_display_name ()

    const gchar *       gdata_gd_email_address_get_display_name
                                                            (GDataGDEmailAddress *self);

Gets the "display-name" property.

`self` : | a GDataGDEmailAddress
Returns : | a display name for the e-mail address, or `NULL`

Since 0.6.0

### gdata_gd_email_address_set_display_name ()

    void                gdata_gd_email_address_set_display_name
                                                            (GDataGDEmailAddress *self,
                                                             const gchar *display_name);

Sets the "display-name" property to `display_name`.

Set `display_name` to `NULL` to unset the property in the e-mail address.

`self` : | a GDataGDEmailAddress
`display_name` : | the new display name, or `NULL`. [allow-none]

Since 0.6.0

## Property Details

### The `"address"` property

      "address"                  gchar*                : Read / Write

The e-mail address itself.

For more information, see the GData specification.

Default value: NULL

Since 0.4.0

### The `"display-name"` property

      "display-name"             gchar*                : Read / Write

A display name of the entity (e.g. a person) the e-mail address belongs to.

For more information, see the GData specification.

Default value: NULL

Since 0.6.0

### The `"is-primary"` property

      "is-primary"               gboolean              : Read / Write

Indicates which e-mail address out of a group is primary.

For more information, see the GData specification.

Default value: FALSE

Since 0.4.0

### The `"label"` property

      "label"                    gchar*                : Read / Write

A simple string value used to name this e-mail address. It allows UIs to display a label such as "Work", "Personal", "Preferred", etc.

For more information, see the GData specification.

Default value: NULL

Since 0.4.0

### The `"relation-type"` property

      "relation-type"            gchar*                : Read / Write

A programmatic value that identifies the type of e-mail address. For example: `GDATA_GD_EMAIL_ADDRESS_HOME` or `GDATA_GD_EMAIL_ADDRESS_WORK`.

For more information, see the GData specification.

Default value: NULL

Since 0.4.0