![]() |
![]() |
![]() |
Evolution Mail Formatter Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces | Properties |
struct EMailPart; enum EMailPartValidityFlags; struct EMailPartValidityPair; EMailPart * e_mail_part_new (CamelMimePart *mime_part
,const gchar *id
); const gchar * e_mail_part_get_id (EMailPart *part
); const gchar * e_mail_part_get_cid (EMailPart *part
); void e_mail_part_set_cid (EMailPart *part
,const gchar *cid
); gboolean e_mail_part_id_has_prefix (EMailPart *part
,const gchar *prefix
); gboolean e_mail_part_id_has_suffix (EMailPart *part
,const gchar *suffix
); gboolean e_mail_part_id_has_substr (EMailPart *part
,const gchar *substr
); CamelMimePart * e_mail_part_ref_mime_part (EMailPart *part
); const gchar * e_mail_part_get_mime_type (EMailPart *part
); void e_mail_part_set_mime_type (EMailPart *part
,const gchar *mime_type
); struct _EMailPartList * e_mail_part_ref_part_list (EMailPart *part
); void e_mail_part_set_part_list (EMailPart *part
,struct _EMailPartList *part_list
); gboolean e_mail_part_get_is_attachment (EMailPart *part
); void e_mail_part_set_is_attachment (EMailPart *part
,gboolean is_attachment
); void e_mail_part_bind_dom_element (EMailPart *part
,WebKitDOMElement *element
); void e_mail_part_update_validity (EMailPart *part
,CamelCipherValidity *validity
,EMailPartValidityFlags validity_type
); CamelCipherValidity * e_mail_part_get_validity (EMailPart *part
,EMailPartValidityFlags validity_type
); gboolean e_mail_part_has_validity (EMailPart *part
); EMailPartValidityFlags e_mail_part_get_validity_flags (EMailPart *part
); gboolean e_mail_part_is_secured (CamelMimePart *part
); const gchar * e_mail_part_snoop_type (CamelMimePart *part
); gboolean e_mail_part_is_attachment (CamelMimePart *part
); void e_mail_part_preserve_charset_in_content_type (CamelMimePart *ipart
,CamelMimePart *opart
); CamelMimePart * e_mail_part_get_related_display_part (CamelMimePart *part
,gint *out_displayid
); void e_mail_part_animation_extract_frame (GBytes *bytes
,gchar **out_frame
,gsize *out_len
); gchar * e_mail_part_build_uri (CamelFolder *folder
,const gchar *message_uid
,const gchar *first_param_name
,...
); gchar * e_mail_part_describe (CamelMimePart *part
,const gchar *mime_type
); gboolean e_mail_part_is_inline (CamelMimePart *part
,GQueue *extensions
); gboolean e_mail_part_utils_body_refers (const gchar *body
,const gchar *cid
);
GObject +----EMailPart +----EMailPartAttachmentBar +----EMailPartAttachment +----EMailPartHeaders +----EMailPartImage
"cid" gchar* : Read / Write "id" gchar* : Read / Write / Construct Only "is-attachment" gboolean : Read / Write / Construct "mime-part" CamelMimePart* : Read / Write / Construct Only "mime-type" gchar* : Read / Write "part-list" EMailPartList* : Read / Write
struct EMailPart;
The EMailPart is a wrapper around CamelMimePart which holds additional information about the mime part, like it's ID, encryption type etc.
Each EMailPart must have a unique ID. The ID is a dot-separated hierarchical description of the location of the part within the email message.
typedef enum { /*< flags >*/ E_MAIL_PART_VALIDITY_NONE = 0, E_MAIL_PART_VALIDITY_PGP = 1 << 0, E_MAIL_PART_VALIDITY_SMIME = 1 << 1, E_MAIL_PART_VALIDITY_SIGNED = 1 << 2, E_MAIL_PART_VALIDITY_ENCRYPTED = 1 << 3 } EMailPartValidityFlags;
struct EMailPartValidityPair { EMailPartValidityFlags validity_type; CamelCipherValidity *validity; };
EMailPart * e_mail_part_new (CamelMimePart *mime_part
,const gchar *id
);
Creates a new EMailPart for the given mime_part
.
gboolean e_mail_part_id_has_prefix (EMailPart *part
,const gchar *prefix
);
gboolean e_mail_part_id_has_suffix (EMailPart *part
,const gchar *suffix
);
gboolean e_mail_part_id_has_substr (EMailPart *part
,const gchar *substr
);
void e_mail_part_set_mime_type (EMailPart *part
,const gchar *mime_type
);
void e_mail_part_set_part_list (EMailPart *part
,struct _EMailPartList *part_list
);
void e_mail_part_set_is_attachment (EMailPart *part
,gboolean is_attachment
);
void e_mail_part_bind_dom_element (EMailPart *part
,WebKitDOMElement *element
);
void e_mail_part_update_validity (EMailPart *part
,CamelCipherValidity *validity
,EMailPartValidityFlags validity_type
);
Updates validity of the part
. When the part already has some validity
set, the new validity
and validity_type
are just appended, preserving
the original validity. Validities of the same type (PGP or S/MIME) are
merged together.
|
An EMailPart |
|
E_MAIL_PART_VALIDITY_* flags |
|
a CamelCipherValidity |
CamelCipherValidity * e_mail_part_get_validity (EMailPart *part
,EMailPartValidityFlags validity_type
);
Returns, validity of part
contains any validity with the same bits
as validity_type
set. It should contain all bits of it.
|
An EMailPart |
|
E_MAIL_PART_VALIDITY_* flags |
Returns : |
a CamelCipherValidity of the given type, NULL if not found |
Since 3.8
EMailPartValidityFlags e_mail_part_get_validity_flags (EMailPart *part
);
gboolean e_mail_part_is_secured (CamelMimePart *part
);
Whether part
is signed or encrypted or not.
|
a CamelMimePart |
Returns : |
TRUE/FALSE |
const gchar * e_mail_part_snoop_type (CamelMimePart *part
);
Tries to snoop the mime type of a part.
|
a CamelMimePart |
Returns : |
NULL if unknown (more likely application/octet-stream). |
gboolean e_mail_part_is_attachment (CamelMimePart *part
);
Returns true if the part is an attachment.
A part is not considered an attachment if it is a multipart, or a text part with no filename. It is used to determine if an attachment header should be displayed for the part.
Content-Disposition is not checked.
|
Part to check. |
Returns : |
TRUE/FALSE |
void e_mail_part_preserve_charset_in_content_type (CamelMimePart *ipart
,CamelMimePart *opart
);
Copies 'charset' part of content-type header from ipart
to opart
.
|
Source CamelMimePart |
|
Target CamelMimePart |
CamelMimePart * e_mail_part_get_related_display_part (CamelMimePart *part
,gint *out_displayid
);
Goes through all subparts of given part
and tries to determine which
part should be displayed and which parts are just attachments to the
part.
|
a multipart/related or multipart/alternative CamelMimePart |
|
(out) returns index of the returned part |
Returns : |
A CamelMimePart that should be displayed |
void e_mail_part_animation_extract_frame (GBytes *bytes
,gchar **out_frame
,gsize *out_len
);
gchar * e_mail_part_build_uri (CamelFolder *folder
,const gchar *message_uid
,const gchar *first_param_name
,...
);
gchar * e_mail_part_describe (CamelMimePart *part
,const gchar *mime_type
);
Generate a simple textual description of a part, mime_type
represents
the content.
|
a CamelMimePart |
|
MIME type of the content |
"is-attachment"
property"is-attachment" gboolean : Read / Write / Construct
Format the part as an attachment.
Default value: FALSE
"part-list"
property"part-list" EMailPartList* : Read / Write
The part list that owns the part.