Top | ![]() |
![]() |
![]() |
![]() |
ESourceMailCompositionESourceMailComposition — ESource extension for mail composition settings |
The ESourceMailComposition extension tracks settings to be applied when composing a new mail message.
Access the extension as follows:
1 2 3 4 5 |
#include <libedataserver/libedataserver.h> ESourceMailComposition *extension; extension = e_source_get_extension (source, E_SOURCE_EXTENSION_MAIL_COMPOSITION); |
gchar **
e_source_mail_composition_dup_bcc (ESourceMailComposition *extension
);
Thread-safe variation of e_source_mail_composition_get_bcc()
.
Use this function when accessing extension
from multiple threads.
The returned string array should be freed with g_strfreev()
when no
longer needed.
Since: 3.6
void e_source_mail_composition_set_bcc (ESourceMailComposition *extension
,const gchar * const *bcc
);
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>".
extension |
an ESource |
|
bcc |
a |
[array zero-terminated=1] |
Since: 3.6
gchar **
e_source_mail_composition_dup_cc (ESourceMailComposition *extension
);
Thread-safe variation of e_source_mail_composition_get_cc()
.
Use this function when accessing extension
from multiple threads.
The returned string array should be freed with g_strfreev()
when no
longer needed.
Since: 3.6
void e_source_mail_composition_set_cc (ESourceMailComposition *extension
,const gchar * const *cc
);
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>".
Since: 3.6
const gchar *
e_source_mail_composition_get_drafts_folder
(ESourceMailComposition *extension
);
Returns a string identifying the preferred folder for draft messages. The format of the identifier string is defined by the client application.
Since: 3.6
gchar *
e_source_mail_composition_dup_drafts_folder
(ESourceMailComposition *extension
);
Thread-safe variation of e_source_mail_composition_get_drafts_folder()
.
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
void e_source_mail_composition_set_drafts_folder (ESourceMailComposition *extension
,const gchar *drafts_folder
);
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,
NULL
is set instead.
extension |
||
drafts_folder |
an identifier for the preferred drafts
folder, or |
[nullable] |
Since: 3.6
gboolean
e_source_mail_composition_get_sign_imip
(ESourceMailComposition *extension
);
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.
Since: 3.6
void e_source_mail_composition_set_sign_imip (ESourceMailComposition *extension
,gboolean sign_imip
);
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.
Since: 3.6
const gchar *
e_source_mail_composition_get_templates_folder
(ESourceMailComposition *extension
);
Returns a string identifying the preferred folder for message templates. The format of the identifier string is defined by the client application.
Since: 3.6
gchar *
e_source_mail_composition_dup_templates_folder
(ESourceMailComposition *extension
);
Thread-safe variation of e_source_mail_composition_get_templates_folder()
.
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
void e_source_mail_composition_set_templates_folder (ESourceMailComposition *extension
,const gchar *templates_folder
);
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,
NULL
is set instead.
extension |
||
templates_folder |
an identifier for the preferred templates
folder, or |
[nullable] |
Since: 3.6
ESourceMailCompositionReplyStyle
e_source_mail_composition_get_reply_style
(ESourceMailComposition *extension
);
Returns preferred reply style to be used when replying
using the associated account. If no preference is set,
the E_SOURCE_MAIL_COMPOSITION_REPLY_STYLE_DEFAULT
is returned.
Since: 3.20
void e_source_mail_composition_set_reply_style (ESourceMailComposition *extension
,ESourceMailCompositionReplyStyle reply_style
);
Sets preferred reply style to be used when replying
using the associated account. To unset the preference,
use the E_SOURCE_MAIL_COMPOSITION_REPLY_STYLE_DEFAULT
.
Since: 3.20
EThreeState
e_source_mail_composition_get_start_bottom
(ESourceMailComposition *extension
);
Returns whether start at bottom when replying or forwarding
using the associated account. If no preference is set,
the E_THREE_STATE_INCONSISTENT
is returned.
Since: 3.26
void e_source_mail_composition_set_start_bottom (ESourceMailComposition *extension
,EThreeState start_bottom
);
Sets whether start bottom when replying or forwarding using the associated account.
To unset the preference, use the E_THREE_STATE_INCONSISTENT
.
Since: 3.26
EThreeState
e_source_mail_composition_get_top_signature
(ESourceMailComposition *extension
);
Returns whether place signature at top when replying or forwarding
using the associated account. If no preference is set,
the E_THREE_STATE_INCONSISTENT
is returned.
Since: 3.26
void e_source_mail_composition_set_top_signature (ESourceMailComposition *extension
,EThreeState top_signature
);
Sets whether place signature at top when replying or forwarding using the associated account.
To unset the preference, use the E_THREE_STATE_INCONSISTENT
.
Since: 3.26
const gchar *
e_source_mail_composition_get_language
(ESourceMailComposition *extension
);
Returns a string identifying the preferred language, like "en_US".
Since: 3.32
gchar *
e_source_mail_composition_dup_language
(ESourceMailComposition *extension
);
Thread-safe variation of e_source_mail_composition_get_language()
.
Use this function when accessing extension
from multiple threads.
The returned string should be freed with g_free()
when no longer needed.
Since: 3.32
void e_source_mail_composition_set_language (ESourceMailComposition *extension
,const gchar *language
);
Sets the preferred language by an identifier string, like "en_US".
Use NULL
to unset any previous value.
The internal copy of language
is automatically stripped of
leading and trailing whitespace. If the resulting string is empty,
NULL
is set instead.
Since: 3.32
#define E_SOURCE_EXTENSION_MAIL_COMPOSITION "Mail Composition"
Pass this extension name to e_source_get_extension()
to access
ESourceMailComposition. This is also used as a group name in key files.
Since: 3.6
struct ESourceMailComposition;
Contains only private data that should be read and manipulated using the functions below.
Since: 3.6