GData.GDEmailAddress¶

Subclasses:: None

Methods¶

Inherited:: GData.Parsable (5), GObject.Object (37), GData.Comparable (1)
Structs:: GObject.ObjectClass (5)

class	`new` (address, relation_type, label, is_primary)
	`get_address` ()
	`get_display_name` ()
	`get_label` ()
	`get_relation_type` ()
	`is_primary` ()
	`set_address` (address)
	`set_display_name` (display_name)
	`set_is_primary` (is_primary)
	`set_label` (label)
	`set_relation_type` (relation_type)

Virtual Methods¶

Inherited:: GData.Parsable (9), GObject.Object (7), GData.Comparable (1)

Properties¶

Inherited:: GData.Parsable (1)

Name	Type	Flags	Short Description
`address`	`str`	r/w	The e-mail address itself.
`display-name`	`str`	r/w	A display name of the entity the e-mail address belongs to.
`is-primary`	`bool`	r/w	Indicates which e-mail address out of a group is primary.
`label`	`str`	r/w	A simple string value used to name this e-mail address.
`relation-type`	`str`	r/w	A programmatic value that identifies the type of e-mail address.

Signals¶

Inherited:: GObject.Object (1)

Fields¶

Inherited:: GObject.Object (1)

Name	Type	Access	Description
parent	`GData.Parsable`	r

Class Details¶

class GData.GDEmailAddress(**kwargs)¶

Bases:: GData.Parsable, GData.Comparable
Abstract:: No
Structure:: GData.GDEmailAddressClass

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

New in version 0.2.0.

classmethod new(address, relation_type, label, is_primary)¶

Parameters:

address (str) – the e-mail address
relation_type (str or None) – the relationship between the e-mail address and its owner, or None
label (str or None) – a human-readable label for the e-mail address, or None
is_primary (bool) – True if this e-mail address is its owner’s primary address, False otherwise

Returns:

a new GData.GDEmailAddress, or None; unref with GObject.Object.unref()

Return type:

GData.GDEmailAddress

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

New in version 0.2.0.

get_address()¶

Returns:: the e-mail address itself, or None
Return type:: str

Gets the GData.GDEmailAddress :address property.

New in version 0.4.0.

get_display_name()¶

Returns:: a display name for the e-mail address, or None
Return type:: str

Gets the GData.GDEmailAddress :display-name property.

New in version 0.6.0.

get_label()¶

Returns:: the e-mail address’ label, or None
Return type:: str

Gets the GData.GDEmailAddress :label property.

New in version 0.4.0.

get_relation_type()¶

Returns:: the e-mail address’ relation type, or None
Return type:: str

Gets the GData.GDEmailAddress :relation-type property.

New in version 0.4.0.

is_primary()¶

Returns:: True if this is the primary e-mail address, False otherwise
Return type:: bool

Gets the GData.GDEmailAddress :is-primary property.

New in version 0.4.0.

set_address(address)¶

Parameters:: address (str) – the new e-mail address

Sets the GData.GDEmailAddress :address property to address.

New in version 0.4.0.

set_display_name(display_name)¶

Parameters:: display_name (str or None) – the new display name, or None

Sets the GData.GDEmailAddress :display-name property to display_name.

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

New in version 0.6.0.

set_is_primary(is_primary)¶

Parameters:: is_primary (bool) – True if this is the primary e-mail address, False otherwise

Sets the GData.GDEmailAddress :is-primary property to is_primary.

New in version 0.4.0.

set_label(label)¶

Parameters:: label (str or None) – the new label for the e-mail address, or None

Sets the GData.GDEmailAddress :label property to label.

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

New in version 0.4.0.

set_relation_type(relation_type)¶

Parameters:: relation_type (str or None) – the new relation type for the email_address, or None

Sets the GData.GDEmailAddress :relation-type property to relation_type.

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

New in version 0.4.0.

Property Details¶

GData.GDEmailAddress.props.address¶

Name:: address
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

The e-mail address itself.

For more information, see the

GData specification.

New in version 0.4.0.

GData.GDEmailAddress.props.display_name¶

Name:: display-name
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

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

For more information, see the

GData specification.

New in version 0.6.0.

GData.GDEmailAddress.props.is_primary¶

Name:: is-primary
Type:: bool
Default Value:: False
Flags:: READABLE, WRITABLE

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

For more information, see the

GData specification.

New in version 0.4.0.

GData.GDEmailAddress.props.label¶

Name:: label
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

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.

New in version 0.4.0.

GData.GDEmailAddress.props.relation_type¶

Name:: relation-type
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

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.

New in version 0.4.0.