![]() |
![]() |
![]() |
Evolution-Data-Server Manual: Utilities (libedataserver) | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
ESourceMailSubmissionESourceMailSubmission — ESource extension for submitting emails |
#include <libedataserver/libedataserver.h> struct ESourceMailSubmission; #define E_SOURCE_EXTENSION_MAIL_SUBMISSION const gchar * e_source_mail_submission_get_sent_folder (ESourceMailSubmission *extension
); gchar * e_source_mail_submission_dup_sent_folder (ESourceMailSubmission *extension
); void e_source_mail_submission_set_sent_folder (ESourceMailSubmission *extension
,const gchar *sent_folder
); const gchar * e_source_mail_submission_get_transport_uid (ESourceMailSubmission *extension
); gchar * e_source_mail_submission_dup_transport_uid (ESourceMailSubmission *extension
); void e_source_mail_submission_set_transport_uid (ESourceMailSubmission *extension
,const gchar *transport_uid
); gboolean e_source_mail_submission_get_replies_to_origin_folder (ESourceMailSubmission *extension
); void e_source_mail_submission_set_replies_to_origin_folder (ESourceMailSubmission *extension
,gboolean replies_to_origin_folder
);
"replies-to-origin-folder" gboolean : Read / Write / Construct "sent-folder" gchar* : Read / Write / Construct "transport-uid" gchar* : Read / Write / Construct
The ESourceMailSubmission extension tracks settings to be applied when submitting a mail message for delivery.
Access the extension as follows:
1 2 3 4 5 |
#include <libedataserver/libedataserver.h> ESourceMailSubmission *extension; extension = e_source_get_extension (source, E_SOURCE_EXTENSION_MAIL_SUBMISSION); |
struct ESourceMailSubmission;
Contains only private data that should be read and manipulated using the function below.
Since 3.6
#define E_SOURCE_EXTENSION_MAIL_SUBMISSION "Mail Submission"
Pass this extension name to e_source_get_extension()
to access
ESourceMailSubmission. This is also used as a group name in key files.
Since 3.6
const gchar * e_source_mail_submission_get_sent_folder
(ESourceMailSubmission *extension
);
Returns a string identifying the preferred folder for sent messages. The format of the identifier string is defined by the client application.
|
an ESourceMailSubmission |
Returns : |
an identifier for the preferred sent folder |
Since 3.6
gchar * e_source_mail_submission_dup_sent_folder
(ESourceMailSubmission *extension
);
Thread-safe variation of e_source_mail_submission_get_sent_folder()
.
Use this function when accessing extension
from multiple threads.
The returned string should be freed with g_free()
when no longer needed.
|
an ESourceMailSubmission |
Returns : |
a newly-allocated copy of "sent-folder" |
Since 3.6
void e_source_mail_submission_set_sent_folder (ESourceMailSubmission *extension
,const gchar *sent_folder
);
Sets the preferred folder for sent messages by an identifier string. The format of the identifier string is defined by the client application.
The internal copy of sent_folder
is automatically stripped of leading
and trailing whitespace. If the resulting string is empty, NULL
is set
instead.
|
an ESourceMailSubmission |
|
an identifier for the preferred sent folder,
or NULL . [allow-none]
|
Since 3.6
const gchar * e_source_mail_submission_get_transport_uid
(ESourceMailSubmission *extension
);
Returns the "uid" of the ESource that describes the mail transport to be used for outgoing messages.
|
an ESourceMailSubmission |
Returns : |
the mail transport "uid" |
Since 3.6
gchar * e_source_mail_submission_dup_transport_uid
(ESourceMailSubmission *extension
);
Thread-safe variation of e_source_mail_submission_get_transport_uid()
.
Use this function when accessing extension
from multiple threads.
The returned string should be freed with g_free()
when no longer needed.
|
an ESourceMailSubmission |
Returns : |
a newly-allocated copy of "transport-uid" |
Since 3.6
void e_source_mail_submission_set_transport_uid (ESourceMailSubmission *extension
,const gchar *transport_uid
);
Sets the "uid" of the ESource that describes the mail transport to be used for outgoing messages.
|
an ESourceMailSubmission |
|
the mail transport "uid", or NULL . [allow-none]
|
Since 3.6
gboolean e_source_mail_submission_get_replies_to_origin_folder
(ESourceMailSubmission *extension
);
Returns whether save replies in the folder of the message being replied to, instead of the Sent folder.
|
an ESourceMailSubmission |
Returns : |
whether save replies in the folder of the message being replied to |
Since 3.8
void e_source_mail_submission_set_replies_to_origin_folder (ESourceMailSubmission *extension
,gboolean replies_to_origin_folder
);
Sets whether save replies in the folder of the message being replied to, instead of the Sent folder.
|
an ESourceMailSubmission |
|
new value |
Since 3.8
"replies-to-origin-folder"
property "replies-to-origin-folder" gboolean : Read / Write / Construct
Whether to save replies to folder of the message being replied to, instead of the Sent folder.
Default value: FALSE
"sent-folder"
property "sent-folder" gchar* : Read / Write / Construct
Preferred folder for sent messages.
Default value: NULL