struct ESourceMailIdentity

struct ESourceMailIdentity;

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

Since 3.6

E_SOURCE_EXTENSION_MAIL_IDENTITY

#define E_SOURCE_EXTENSION_MAIL_IDENTITY "Mail Identity"

Pass this extension name to e_source_get_extension() to access ESourceMailIdentity. This is also used as a group name in key files.

Since 3.6

e_source_mail_identity_get_address ()

const gchar *       e_source_mail_identity_get_address  (ESourceMailIdentity *extension);

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

Since 3.6

e_source_mail_identity_dup_address ()

gchar *             e_source_mail_identity_dup_address  (ESourceMailIdentity *extension);

Thread-safe variation of e_source_mail_identity_get_address(). Use this function when accessing extension from multiple threads.

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

Since 3.6

e_source_mail_identity_set_address ()

void                e_source_mail_identity_set_address  (ESourceMailIdentity *extension,
                                                         const gchar *address);

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, NULL is set instead.

Since 3.6

e_source_mail_identity_get_name ()

const gchar *       e_source_mail_identity_get_name     (ESourceMailIdentity *extension);

Returns the sender's name for this identity.

Since 3.6

e_source_mail_identity_dup_name ()

gchar *             e_source_mail_identity_dup_name     (ESourceMailIdentity *extension);

Thread-safe variation of e_source_mail_identity_get_name(). Use this function when accessing extension from multiple threads.

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

Since 3.6

e_source_mail_identity_set_name ()

void                e_source_mail_identity_set_name     (ESourceMailIdentity *extension,
                                                         const gchar *name);

Sets the sender's name for this identity.

The internal copy of name is automatically stripped of leading and trailing whitespace. If name is NULL or the resulting string is empty, the result of g_get_real_name() is set instead.

Since 3.6

e_source_mail_identity_get_organization ()

const gchar *       e_source_mail_identity_get_organization
                                                        (ESourceMailIdentity *extension);

Returns the sender's organization for this identity.

Since 3.6

e_source_mail_identity_dup_organization ()

gchar *             e_source_mail_identity_dup_organization
                                                        (ESourceMailIdentity *extension);

Thread-safe variation of e_source_mail_identity_dup_organization(). Use this function when accessing extension from multiple threads.

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

Since 3.6

e_source_mail_identity_set_organization ()

void                e_source_mail_identity_set_organization
                                                        (ESourceMailIdentity *extension,
                                                         const gchar *organization);

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, NULL is set instead.

Since 3.6

e_source_mail_identity_get_reply_to ()

const gchar *       e_source_mail_identity_get_reply_to (ESourceMailIdentity *extension);

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

Since 3.6

e_source_mail_identity_dup_reply_to ()

gchar *             e_source_mail_identity_dup_reply_to (ESourceMailIdentity *extension);

Thread-safe variation of e_source_mail_identity_get_reply_to(). Use this function when accessing extension from multiple threads.

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

Since 3.6

e_source_mail_identity_set_reply_to ()

void                e_source_mail_identity_set_reply_to (ESourceMailIdentity *extension,
                                                         const gchar *reply_to);

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, NULL is set instead.

Since 3.6

e_source_mail_identity_get_signature_uid ()

const gchar *       e_source_mail_identity_get_signature_uid
                                                        (ESourceMailIdentity *extension);

Returns the "uid" of an ESource describing a mail signature.

If the user does not want to use a signature for this identity, the convention is to set the "signature-uid" property to "none".

Since 3.6

e_source_mail_identity_dup_signature_uid ()

gchar *             e_source_mail_identity_dup_signature_uid
                                                        (ESourceMailIdentity *extension);

Thread-safe variation of e_source_mail_identity_get_signature_uid(). Use this function when accessing extension from multiple threads.

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

Since 3.6

e_source_mail_identity_set_signature_uid ()

void                e_source_mail_identity_set_signature_uid
                                                        (ESourceMailIdentity *extension,
                                                         const gchar *signature_uid);

Sets the "uid" of an ESource describing a mail signature.

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

Since 3.6

The "address" property

  "address"                  gchar*                : Read / Write / Construct

Sender's email address.

Default value: NULL

The "name" property

  "name"                     gchar*                : Read / Write / Construct

Sender's name.

Default value: NULL

The "organization" property

  "organization"             gchar*                : Read / Write / Construct

Sender's organization.

Default value: NULL

The "reply-to" property

  "reply-to"                 gchar*                : Read / Write / Construct

Sender's reply-to address.

Default value: NULL

The "signature-uid" property

  "signature-uid"            gchar*                : Read / Write / Construct

ESource UID of the sender's signature.

Default value: "none"