EAttachment: Evolution Utilities Reference Manual

## EAttachment EAttachment |

## Functions

EAttachment * | e_attachment_new ()
EAttachment * | e_attachment_new_for_path ()
EAttachment * | e_attachment_new_for_uri ()
EAttachment * | e_attachment_new_for_message ()
void | e_attachment_add_to_multipart ()
void | e_attachment_cancel ()
gboolean | e_attachment_get_can_show ()
void | e_attachment_set_can_show ()
const gchar * | e_attachment_get_disposition ()
gchar * | e_attachment_dup_disposition ()
void | e_attachment_set_disposition ()
GFile * | e_attachment_ref_file ()
void | e_attachment_set_file ()
GFileInfo * | e_attachment_ref_file_info ()
void | e_attachment_set_file_info ()
gchar * | e_attachment_dup_mime_type ()
GIcon * | e_attachment_ref_icon ()
gboolean | e_attachment_get_loading ()
CamelMimePart * | e_attachment_ref_mime_part ()
void | e_attachment_set_mime_part ()
gint | e_attachment_get_percent ()
GtkTreeRowReference * | e_attachment_get_reference ()
void | e_attachment_set_reference ()
gboolean | e_attachment_get_saving ()
gboolean | e_attachment_get_shown ()
void | e_attachment_set_shown ()
camel_cipher_validity_encrypt_t | e_attachment_get_encrypted ()
void | e_attachment_set_encrypted ()
camel_cipher_validity_sign_t | e_attachment_get_signed ()
void | e_attachment_set_signed ()
gchar * | e_attachment_dup_description ()
gchar * | e_attachment_dup_thumbnail_path ()
gboolean | e_attachment_is_rfc822 ()
GList * | e_attachment_list_apps ()
void | e_attachment_load_async ()
gboolean | e_attachment_load_finish ()
gboolean | e_attachment_load ()
void | e_attachment_open_async ()
gboolean | e_attachment_open_finish ()
gboolean | e_attachment_open ()
void | e_attachment_save_async ()
GFile * | e_attachment_save_finish ()
gboolean | e_attachment_save ()
void | e_attachment_load_handle_error ()
void | e_attachment_open_handle_error ()
void | e_attachment_save_handle_error ()

## Properties

gboolean | can-show | Read / Write / Construct
gchar * | disposition | Read / Write / Construct
gint | encrypted | Read / Write / Construct
GFile * | file | Read / Write / Construct
GFileInfo * | file-info | Read
GIcon * | icon | Read
gboolean | loading | Read
CamelMimePart * | mime-part | Read / Write
gint | percent | Read
GtkTreeRowReference * | reference | Read / Write
gboolean | save-extracted | Read / Write
gboolean | save-self | Read / Write
gboolean | saving | Read
gboolean | shown | Read / Write / Construct
gint | signed | Read / Write / Construct

## Types and Values

struct | EAttachment

## Object Hierarchy

        GObject
        ╰── EAttachment

## Description

## Functions

### e_attachment_new ()

    EAttachment *
    e_attachment_new (void);

### e_attachment_new_for_path ()

    EAttachment *
    e_attachment_new_for_path (const gchar *path);

### e_attachment_new_for_uri ()

    EAttachment *
    e_attachment_new_for_uri (const gchar *uri);

### e_attachment_new_for_message ()

    EAttachment *
    e_attachment_new_for_message (CamelMimeMessage *message);

### e_attachment_add_to_multipart ()

    void
    e_attachment_add_to_multipart (EAttachment *attachment,
                                   CamelMultipart *multipart,
                                   const gchar *default_charset);

### e_attachment_cancel ()

    void
    e_attachment_cancel (EAttachment *attachment);

### e_attachment_get_can_show ()

    gboolean
    e_attachment_get_can_show (EAttachment *attachment);

### e_attachment_set_can_show ()

    void
    e_attachment_set_can_show (EAttachment *attachment,
                               gboolean can_show);

### e_attachment_get_disposition ()

    const gchar *
    e_attachment_get_disposition (EAttachment *attachment);

### e_attachment_dup_disposition ()

    gchar *
    e_attachment_dup_disposition (EAttachment *attachment);

### e_attachment_set_disposition ()

    void
    e_attachment_set_disposition (EAttachment *attachment,
                                  const gchar *disposition);

### e_attachment_ref_file ()

    GFile *
    e_attachment_ref_file (EAttachment *attachment);

### e_attachment_set_file ()

    void
    e_attachment_set_file (EAttachment *attachment,
                           GFile *file);

### e_attachment_ref_file_info ()

    GFileInfo *
    e_attachment_ref_file_info (EAttachment *attachment);

### e_attachment_set_file_info ()

    void
    e_attachment_set_file_info (EAttachment *attachment,
                                GFileInfo *file_info);

### e_attachment_dup_mime_type ()

    gchar *
    e_attachment_dup_mime_type (EAttachment *attachment);

Returns the MIME type of `attachment` according to its GFileInfo. If the `attachment` has no GFileInfo then the function returns `NULL`. Free the returned MIME type string with `g_free()`.

#### Parameters

attachment | an EAttachment |

#### Returns

a newly-allocated MIME type string, or `NULL`

### e_attachment_ref_icon ()

    GIcon *
    e_attachment_ref_icon (EAttachment *attachment);

### e_attachment_get_loading ()

    gboolean
    e_attachment_get_loading (EAttachment *attachment);

### e_attachment_ref_mime_part ()

    CamelMimePart *
    e_attachment_ref_mime_part (EAttachment *attachment);

### e_attachment_set_mime_part ()

    void
    e_attachment_set_mime_part (EAttachment *attachment,
                                CamelMimePart *mime_part);

### e_attachment_get_percent ()

    gint
    e_attachment_get_percent (EAttachment *attachment);

### e_attachment_get_reference ()

    GtkTreeRowReference *
    e_attachment_get_reference (EAttachment *attachment);

### e_attachment_set_reference ()

    void
    e_attachment_set_reference (EAttachment *attachment,
                                GtkTreeRowReference *reference);

### e_attachment_get_saving ()

    gboolean
    e_attachment_get_saving (EAttachment *attachment);

### e_attachment_get_shown ()

    gboolean
    e_attachment_get_shown (EAttachment *attachment);

### e_attachment_set_shown ()

    void
    e_attachment_set_shown (EAttachment *attachment,
                            gboolean shown);

### e_attachment_get_encrypted ()

    camel_cipher_validity_encrypt_t
    e_attachment_get_encrypted (EAttachment *attachment);

### e_attachment_set_encrypted ()

    void
    e_attachment_set_encrypted (EAttachment *attachment,
                                camel_cipher_validity_encrypt_t encrypted);

### e_attachment_get_signed ()

    camel_cipher_validity_sign_t
    e_attachment_get_signed (EAttachment *attachment);

### e_attachment_set_signed ()

    void
    e_attachment_set_signed (EAttachment *attachment,
                             camel_cipher_validity_sign_t signed_);

### e_attachment_dup_description ()

    gchar *
    e_attachment_dup_description (EAttachment *attachment);

### e_attachment_dup_thumbnail_path ()

    gchar *
    e_attachment_dup_thumbnail_path (EAttachment *attachment);

### e_attachment_is_rfc822 ()

    gboolean
    e_attachment_is_rfc822 (EAttachment *attachment);

### e_attachment_list_apps ()

    GList *
    e_attachment_list_apps (EAttachment *attachment);

### e_attachment_load_async ()

    void
    e_attachment_load_async (EAttachment *attachment,
                             GAsyncReadyCallback callback,
                             gpointer user_data);

### e_attachment_load_finish ()

    gboolean
    e_attachment_load_finish (EAttachment *attachment,
                              GAsyncResult *result,
                              GError **error);

### e_attachment_load ()

    gboolean
    e_attachment_load (EAttachment *attachment,
                       GError **error);

### e_attachment_open_async ()

    void
    e_attachment_open_async (EAttachment *attachment,
                             GAppInfo *app_info,
                             GAsyncReadyCallback callback,
                             gpointer user_data);

### e_attachment_open_finish ()

    gboolean
    e_attachment_open_finish (EAttachment *attachment,
                              GAsyncResult *result,
                              GError **error);

### e_attachment_open ()

    gboolean
    e_attachment_open (EAttachment *attachment,
                       GAppInfo *app_info,
                       GError **error);

### e_attachment_save_async ()

    void
    e_attachment_save_async (EAttachment *attachment,
                             GFile *destination,
                             GAsyncReadyCallback callback,
                             gpointer user_data);

### e_attachment_save_finish ()

    GFile *
    e_attachment_save_finish (EAttachment *attachment,
                              GAsyncResult *result,
                              GError **error);

### e_attachment_save ()

    gboolean
    e_attachment_save (EAttachment *attachment,
                       GFile *in_destination,
                       GFile **out_destination,
                       GError **error);

### e_attachment_load_handle_error ()

    void
    e_attachment_load_handle_error (EAttachment *attachment,
                                    GAsyncResult *result,
                                    GtkWindow *parent);

### e_attachment_open_handle_error ()

    void
    e_attachment_open_handle_error (EAttachment *attachment,
                                    GAsyncResult *result,
                                    GtkWindow *parent);

### e_attachment_save_handle_error ()

    void
    e_attachment_save_handle_error (EAttachment *attachment,
                                    GAsyncResult *result,
                                    GtkWindow *parent);

## Types and Values

### struct EAttachment

    struct EAttachment;

## Property Details

### The `“can-show”` property

      “can-show”                 gboolean

Flags: Read / Write / Construct

Default value: FALSE

### The `“disposition”` property

      “disposition”              gchar *

Flags: Read / Write / Construct

Default value: "attachment"

### The `“encrypted”` property

      “encrypted”                gint

Flags: Read / Write / Construct

Allowed values: [0,3]

Default value: 0

### The `“file”` property

      “file”                     GFile *

Flags: Read / Write / Construct

### The `“file-info”` property

      “file-info”                GFileInfo *

Flags: Read

### The `“icon”` property

      “icon”                     GIcon *

Flags: Read

### The `“loading”` property

      “loading”                  gboolean

Flags: Read

Default value: FALSE

### The `“mime-part”` property

      “mime-part”                CamelMimePart *

Flags: Read / Write

### The `“percent”` property

      “percent”                  gint

Flags: Read

Allowed values: [0,100]

Default value: 0

### The `“reference”` property

      “reference”                GtkTreeRowReference *

Flags: Read / Write

### The `“save-extracted”` property

      “save-extracted”           gboolean

Flags: Read / Write

Default value: FALSE

### The `“save-self”` property

      “save-self”                gboolean

Flags: Read / Write

Default value: TRUE

### The `“saving”` property

      “saving”                   gboolean

Flags: Read

Default value: FALSE

### The `“shown”` property

      “shown”                    gboolean

Flags: Read / Write / Construct

Default value: FALSE

### The `“signed”` property

      “signed”                   gint

Flags: Read / Write / Construct

Allowed values: [0,4]

Default value: 0