EDataServer.SourceMailIdentity

g EDataServer.SourceExtension EDataServer.SourceExtension EDataServer.SourceMailIdentity EDataServer.SourceMailIdentity EDataServer.SourceExtension->EDataServer.SourceMailIdentity GObject.Object GObject.Object GObject.Object->EDataServer.SourceExtension

Subclasses:None

Virtual Methods

Inherited:GObject.Object (7)

Properties

Inherited:EDataServer.SourceExtension (1)
Name Type Flags Short Description
address str r/w/c/en Sender’s email address
aliases str r/w/c/en Sender’s email address aliases
name str r/w/c/en Sender’s name
organization str r/w/c/en Sender’s organization
reply-to str r/w/c/en Sender’s reply-to address
signature-uid str r/w/c/en EDataServer.Source UID of the sender’s signature

Signals

Inherited:GObject.Object (1)

Fields

Inherited:GObject.Object (1)
Name Type Access Description
parent EDataServer.SourceExtension r  

Class Details

class EDataServer.SourceMailIdentity(**kwargs)
Bases:EDataServer.SourceExtension
Abstract:No
Structure:EDataServer.SourceMailIdentityClass

Contains only private data that should be read and manipulated using the functions below.

New in version 3.6.

dup_address()
Returns:a newly-allocated copy of EDataServer.SourceMailIdentity :address
Return type:str

Thread-safe variation of EDataServer.SourceMailIdentity.get_address(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.6.

dup_aliases()
Returns:a newly-allocated copy of EDataServer.SourceMailIdentity :aliases
Return type:str

Thread-safe variation of EDataServer.SourceMailIdentity.get_aliases(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.24.

dup_name()
Returns:a newly-allocated copy of EDataServer.SourceMailIdentity :name
Return type:str

Thread-safe variation of EDataServer.SourceMailIdentity.get_name(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.6.

dup_organization()
Returns:a newly-allocated copy of EDataServer.SourceMailIdentity :organization
Return type:str

Thread-safe variation of EDataServer.SourceMailIdentity.dup_organization(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.6.

dup_reply_to()
Returns:a newly-allocated copy of EDataServer.SourceMailIdentity :reply-to
Return type:str

Thread-safe variation of EDataServer.SourceMailIdentity.get_reply_to(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.6.

dup_signature_uid()
Returns:a newly-allocated copy of EDataServer.SourceMailIdentity :signature-uid
Return type:str

Thread-safe variation of EDataServer.SourceMailIdentity.get_signature_uid(). Use this function when accessing self from multiple threads.

The returned string should be freed with GLib.free() when no longer needed.

New in version 3.6.

get_address()
Returns:the sender’s email address
Return type:str

Returns the email address for this identity from which to send messages. This may be an empty string but will never be None.

New in version 3.6.

get_aliases()
Returns:the sender’s email address aliases
Return type:str

Returns the email address aliases for this identity. These are comma-separated email addresses which may or may not contain also different name. This may be an empty string, but will never be None. There can be used Camel.Address.decode() on a Camel.InternetAddress to decode the list of aliases.

New in version 3.24.

get_aliases_as_hash_table()
Returns:A newly created GLib.HashTable will all the aliases. Returns None if there are none set. Use GLib.HashTable.destroy() to free the returned hash table.
Return type:{str: str} or None

Returns a set aliases as a hash table with address as key and name as value of the hash table. The name can be sometimes empty or None, thus rather use GLib.HashTable.contains() when checking for particular address. The addresses are compared case insensitively. The same addresses with a different name are included only once, the last variant of it. Use EDataServer.SourceMailIdentity.get_aliases() if you need more fine-grained control on the list of aliases.

New in version 3.24.

get_name()
Returns:the sender’s name
Return type:str

Returns the sender’s name for this identity.

New in version 3.6.

get_organization()
Returns:the sender’s organization
Return type:str

Returns the sender’s organization for this identity.

New in version 3.6.

get_reply_to()
Returns:the sender’s reply-to address
Return type:str

Returns the email address for this identity to which recipients should send replies.

New in version 3.6.

get_signature_uid()
Returns:the sender’s signature ID, or “none”
Return type:str

Returns the EDataServer.Source :uid of an EDataServer.Source describing a mail signature.

If the user does not want to use a signature for this identity, the convention is to set the EDataServer.SourceMailIdentity :signature-uid property to “none”.

New in version 3.6.

set_address(address)
Parameters:address (str or None) – the sender’s email address, or None

Sets the email address for this identity from which to send messages.

The internal copy of address is automatically stripped of leading and trailing whitespace. If the resulting string is empty, None is set instead.

New in version 3.6.

set_aliases(aliases)
Parameters:aliases (str or None) – the sender’s email address aliases, or None

Sets the email address aliases for this identity. These are comma-separated email addresses which may or may not contain also different name.

The internal copy of aliases is automatically stripped of leading and trailing whitespace. If the resulting string is empty, None is set instead.

New in version 3.24.

set_name(name)
Parameters:name (str or None) – the sender’s name, or None

Sets the sender’s name for this identity.

The internal copy of name is automatically stripped of leading and trailing whitespace.

New in version 3.6.

set_organization(organization)
Parameters:organization (str or None) – the sender’s organization, or None

Sets the sender’s organization for this identity.

The internal copy of organization is automatically stripped of leading and trailing whitespace. If the resulting string is empty, None is set instead.

New in version 3.6.

set_reply_to(reply_to)
Parameters:reply_to (str or None) – the sender’s reply-to address, or None

Sets the email address for this identity to which recipients should send replies.

The internal copy of reply_to is automatically stripped of leading and trailing whitespace. If the resulting string is empty, None is set instead.

New in version 3.6.

set_signature_uid(signature_uid)
Parameters:signature_uid (str or None) – the sender’s signature ID, or None

Sets the EDataServer.Source :uid of an EDataServer.Source describing a mail signature.

If the user does not want to use a signature for this identity, the convention is to set the EDataServer.SourceMailIdentity :signature-uid property to “none”. In keeping with that convention, the property will be set to “none” if signature is None or an empty string.

New in version 3.6.

Property Details

EDataServer.SourceMailIdentity.props.address
Name:address
Type:str
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Sender’s email address

EDataServer.SourceMailIdentity.props.aliases
Name:aliases
Type:str
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Sender’s email address aliases

EDataServer.SourceMailIdentity.props.name
Name:name
Type:str
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Sender’s name

EDataServer.SourceMailIdentity.props.organization
Name:organization
Type:str
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Sender’s organization

EDataServer.SourceMailIdentity.props.reply_to
Name:reply-to
Type:str
Default Value:None
Flags:READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Sender’s reply-to address

EDataServer.SourceMailIdentity.props.signature_uid
Name:signature-uid
Type:str
Default Value:'none'
Flags:READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

EDataServer.Source UID of the sender’s signature