EDataServer.SourceMailComposition

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

Subclasses:

None

Methods

Inherited:

EDataServer.SourceExtension (4), GObject.Object (37)

Structs:

GObject.ObjectClass (5)

dup_bcc ()

dup_cc ()

dup_drafts_folder ()

dup_language ()

dup_templates_folder ()

get_bcc ()

get_cc ()

get_drafts_folder ()

get_language ()

get_reply_style ()

get_sign_imip ()

get_start_bottom ()

get_templates_folder ()

get_top_signature ()

set_bcc (bcc)

set_cc (cc)

set_drafts_folder (drafts_folder)

set_language (language)

set_reply_style (reply_style)

set_sign_imip (sign_imip)

set_start_bottom (start_bottom)

set_templates_folder (templates_folder)

set_top_signature (top_signature)

Virtual Methods

Inherited:

GObject.Object (7)

Properties

Inherited:

EDataServer.SourceExtension (1)

Name

Type

Flags

Short Description

bcc

[str]

r/w/c/en

Recipients to blind carbon-copy

cc

[str]

r/w/c/en

Recipients to carbon-copy

drafts-folder

str

r/w/c/en

Preferred folder for draft messages

language

str

r/w/c/en

Preferred language

reply-style

EDataServer.SourceMailCompositionReplyStyle

r/w/c/en

What reply style to prefer

sign-imip

bool

r/w/c/en

Include iMIP messages when signing

start-bottom

EDataServer.ThreeState

r/w/c/en

Whether start at bottom on reply or forward

templates-folder

str

r/w/c/en

Preferred folder for message templates

top-signature

EDataServer.ThreeState

r/w/c/en

Whether place signature at the top on reply or forward

Signals

Inherited:

GObject.Object (1)

Fields

Inherited:

GObject.Object (1)

Name

Type

Access

Description

parent

EDataServer.SourceExtension

r

Class Details

class EDataServer.SourceMailComposition(**kwargs)
Bases:

EDataServer.SourceExtension

Abstract:

No

Structure:

EDataServer.SourceMailCompositionClass

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

New in version 3.6.

dup_bcc()
Returns:

a newly-allocated copy of EDataServer.SourceMailComposition :bcc

Return type:

[str]

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

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

New in version 3.6.

dup_cc()
Returns:

a newly-allocated copy of EDataServer.SourceMailComposition :cc

Return type:

[str]

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

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

New in version 3.6.

dup_drafts_folder()
Returns:

a newly-allocated copy of EDataServer.SourceMailComposition :drafts-folder

Return type:

str or None

Thread-safe variation of EDataServer.SourceMailComposition.get_drafts_folder(). 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_language()
Returns:

a newly-allocated copy of EDataServer.SourceMailComposition :language

Return type:

str or None

Thread-safe variation of EDataServer.SourceMailComposition.get_language(). 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.32.

dup_templates_folder()
Returns:

a newly-allocated copy of EDataServer.SourceMailComposition :templates-folder

Return type:

str or None

Thread-safe variation of EDataServer.SourceMailComposition.get_templates_folder(). 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_bcc()
Returns:

a None-terminated string array of Bcc recipients

Return type:

[str]

Returns a None-terminated string array of recipients which should automatically be added to the blind carbon-copy (Bcc) list when composing a new mail message. The recipient strings should be of the form “Full Name <email-address>”. The returned array is owned by self and should not be modified or freed.

New in version 3.6.

get_cc()
Returns:

a None-terminated string array of Cc recipients

Return type:

[str]

Returns a None-terminated string array of recipients which should automatically be added to the carbon-copy (Cc) list when composing a new mail message. The recipient strings should be of the form “Full Name <email-address>”. The returned array is owned by self and should not be modified or freed.

New in version 3.6.

get_drafts_folder()
Returns:

an identifier for the preferred drafts folder

Return type:

str or None

Returns a string identifying the preferred folder for draft messages. The format of the identifier string is defined by the client application.

New in version 3.6.

get_language()
Returns:

an identifier for the preferred language, or None for none

Return type:

str or None

Returns a string identifying the preferred language, like “en_US”.

New in version 3.32.

get_reply_style()
Returns:

reply style preference

Return type:

EDataServer.SourceMailCompositionReplyStyle

Returns preferred reply style to be used when replying using the associated account. If no preference is set, the EDataServer.SourceMailCompositionReplyStyle.DEFAULT is returned.

New in version 3.20.

get_sign_imip()
Returns:

whether outgoing iMIP messages should be signed

Return type:

bool

Returns whether outgoing iMIP messages such as meeting requests should also be signed. This is primarily intended as a workaround for certain versions of Microsoft Outlook which can’t handle signed iMIP messages.

New in version 3.6.

get_start_bottom()
Returns:

start bottom on reply or forward preference

Return type:

EDataServer.ThreeState

Returns whether start at bottom when replying or forwarding using the associated account. If no preference is set, the EDataServer.ThreeState.INCONSISTENT is returned.

New in version 3.26.

get_templates_folder()
Returns:

an identifier for the preferred templates folder

Return type:

str or None

Returns a string identifying the preferred folder for message templates. The format of the identifier string is defined by the client application.

New in version 3.6.

get_top_signature()
Returns:

top signature on reply or forward preference

Return type:

EDataServer.ThreeState

Returns whether place signature at top when replying or forwarding using the associated account. If no preference is set, the EDataServer.ThreeState.INCONSISTENT is returned.

New in version 3.26.

set_bcc(bcc)
Parameters:

bcc ([str]) – a None-terminated string array of Bcc recipients

Sets the recipients which should automatically be added to the blind carbon-copy (Bcc) list when composing a new mail message. The recipient strings should be of the form “Full Name <email-address>”.

New in version 3.6.

set_cc(cc)
Parameters:

cc ([str]) – a None-terminated string array of Cc recipients

Sets the recipients which should automatically be added to the carbon copy (Cc) list when composing a new mail message. The recipient strings should be of the form “Full Name <email-address>”.

New in version 3.6.

set_drafts_folder(drafts_folder)
Parameters:

drafts_folder (str or None) – an identifier for the preferred drafts folder, or None

Sets the preferred folder for draft messages by an identifier string. The format of the identifier string is defined by the client application.

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

New in version 3.6.

set_language(language)
Parameters:

language (str or None) – an identifier for the preferred language, or None

Sets the preferred language by an identifier string, like “en_US”. Use None to unset any previous value.

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

New in version 3.32.

set_reply_style(reply_style)
Parameters:

reply_style (EDataServer.SourceMailCompositionReplyStyle) – an EDataServer.SourceMailCompositionReplyStyle

Sets preferred reply style to be used when replying using the associated account. To unset the preference, use the EDataServer.SourceMailCompositionReplyStyle.DEFAULT.

New in version 3.20.

set_sign_imip(sign_imip)
Parameters:

sign_imip (bool) – whether outgoing iMIP messages should be signed

Sets whether outgoing iMIP messages such as meeting requests should also be signed. This is primarily intended as a workaround for certain versions of Microsoft Outlook which can’t handle signed iMIP messages.

New in version 3.6.

set_start_bottom(start_bottom)
Parameters:

start_bottom (EDataServer.ThreeState) – an EDataServer.ThreeState

Sets whether start bottom when replying or forwarding using the associated account. To unset the preference, use the EDataServer.ThreeState.INCONSISTENT.

New in version 3.26.

set_templates_folder(templates_folder)
Parameters:

templates_folder (str or None) – an identifier for the preferred templates folder, or None

Sets the preferred folder for message templates by an identifier string. The format of the identifier string is defined by the client application.

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

New in version 3.6.

set_top_signature(top_signature)
Parameters:

top_signature (EDataServer.ThreeState) – an EDataServer.ThreeState

Sets whether place signature at top when replying or forwarding using the associated account. To unset the preference, use the EDataServer.ThreeState.INCONSISTENT.

New in version 3.26.

Property Details

EDataServer.SourceMailComposition.props.bcc
Name:

bcc

Type:

[str]

Default Value:

[]

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Recipients to blind carbon-copy

EDataServer.SourceMailComposition.props.cc
Name:

cc

Type:

[str]

Default Value:

[]

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Recipients to carbon-copy

EDataServer.SourceMailComposition.props.drafts_folder
Name:

drafts-folder

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Preferred folder for draft messages

EDataServer.SourceMailComposition.props.language
Name:

language

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Preferred language

EDataServer.SourceMailComposition.props.reply_style
Name:

reply-style

Type:

EDataServer.SourceMailCompositionReplyStyle

Default Value:

EDataServer.SourceMailCompositionReplyStyle.DEFAULT

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

What reply style to prefer

EDataServer.SourceMailComposition.props.sign_imip
Name:

sign-imip

Type:

bool

Default Value:

True

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Include iMIP messages when signing

EDataServer.SourceMailComposition.props.start_bottom
Name:

start-bottom

Type:

EDataServer.ThreeState

Default Value:

EDataServer.ThreeState.INCONSISTENT

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Whether start at bottom on reply or forward

EDataServer.SourceMailComposition.props.templates_folder
Name:

templates-folder

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Preferred folder for message templates

EDataServer.SourceMailComposition.props.top_signature
Name:

top-signature

Type:

EDataServer.ThreeState

Default Value:

EDataServer.ThreeState.INCONSISTENT

Flags:

READABLE, WRITABLE, CONSTRUCT, EXPLICIT_NOTIFY

Whether place signature at the top on reply or forward