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_is_mail_note ()
gboolean | e_attachment_is_uri ()
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 ()
gboolean | e_attachment_get_saving ()
gboolean | e_attachment_get_initially_shown ()
void | e_attachment_set_initially_shown ()
gboolean | e_attachment_get_save_self ()
void | e_attachment_set_save_self ()
gboolean | e_attachment_get_save_extracted ()
void | e_attachment_set_save_extracted ()
CamelCipherValidityEncrypt | e_attachment_get_encrypted ()
void | e_attachment_set_encrypted ()
CamelCipherValiditySign | 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 ()
GAppInfo * | e_attachment_ref_default_app ()
void | e_attachment_update_store_columns ()
gboolean | e_attachment_check_file_changed ()
void | e_attachment_set_may_reload ()
gboolean | e_attachment_get_may_reload ()
void | e_attachment_set_is_possible ()
gboolean | e_attachment_get_is_possible ()
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
char * | disposition | Read / Write / Construct
int | encrypted | Read / Write / Construct
GFile * | file | Read / Write / Construct
GFileInfo * | file-info | Read
GIcon * | icon | Read
gboolean | initially-shown | Read / Write / Construct
gboolean | is-possible | Read / Write / Construct
gboolean | loading | Read
gboolean | may-reload | Read / Write / Construct
CamelMimePart * | mime-part | Read / Write
int | percent | Read
gboolean | save-extracted | Read / Write
gboolean | save-self | Read / Write
gboolean | saving | Read
int | signed | Read / Write / Construct

## Signals

void | load-failed | Run Last
void | update-file-info | Run Last
void | update-icon | Run Last
void | update-progress | Run Last

## 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_is_mail_note ()

    gboolean
    e_attachment_is_mail_note (EAttachment *attachment);

### e_attachment_is_uri ()

    gboolean
    e_attachment_is_uri (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_saving ()

    gboolean
    e_attachment_get_saving (EAttachment *attachment);

### e_attachment_get_initially_shown ()

    gboolean
    e_attachment_get_initially_shown (EAttachment *attachment);

### e_attachment_set_initially_shown ()

    void
    e_attachment_set_initially_shown (EAttachment *attachment,
                                      gboolean initially_shown);

### e_attachment_get_save_self ()

    gboolean
    e_attachment_get_save_self (EAttachment *attachment);

### e_attachment_set_save_self ()

    void
    e_attachment_set_save_self (EAttachment *attachment,
                                gboolean save_self);

### e_attachment_get_save_extracted ()

    gboolean
    e_attachment_get_save_extracted (EAttachment *attachment);

### e_attachment_set_save_extracted ()

    void
    e_attachment_set_save_extracted (EAttachment *attachment,
                                     gboolean save_extracted);

### e_attachment_get_encrypted ()

    CamelCipherValidityEncrypt
    e_attachment_get_encrypted (EAttachment *attachment);

### e_attachment_set_encrypted ()

    void
    e_attachment_set_encrypted (EAttachment *attachment,
                                CamelCipherValidityEncrypt encrypted);

### e_attachment_get_signed ()

    CamelCipherValiditySign
    e_attachment_get_signed (EAttachment *attachment);

### e_attachment_set_signed ()

    void
    e_attachment_set_signed (EAttachment *attachment,
                             CamelCipherValiditySign 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_ref_default_app ()

    GAppInfo *
    e_attachment_ref_default_app (EAttachment *attachment);

### e_attachment_update_store_columns ()

    void
    e_attachment_update_store_columns (EAttachment *attachment);

### e_attachment_check_file_changed ()

    gboolean
    e_attachment_check_file_changed (EAttachment *attachment,
                                     gboolean *out_file_exists,
                                     GCancellable *cancellable);

### e_attachment_set_may_reload ()

    void
    e_attachment_set_may_reload (EAttachment *attachment,
                                 gboolean may_reload);

### e_attachment_get_may_reload ()

    gboolean
    e_attachment_get_may_reload (EAttachment *attachment);

### e_attachment_set_is_possible ()

    void
    e_attachment_set_is_possible (EAttachment *attachment,
                                  gboolean is_possible);

### e_attachment_get_is_possible ()

    gboolean
    e_attachment_get_is_possible (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);

## Property Details

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

      “can-show”                 gboolean

Owner: EAttachment

Flags: Read / Write / Construct

Default value: FALSE

### The `“disposition”` property

      “disposition”              char *

Owner: EAttachment

Flags: Read / Write / Construct

Default value: "attachment"

### The `“encrypted”` property

      “encrypted”                int

Owner: EAttachment

Flags: Read / Write / Construct

Allowed values: [0,3]

Default value: 0

### The `“file”` property

      “file”                     GFile *

Owner: EAttachment

Flags: Read / Write / Construct

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

      “file-info”                GFileInfo *

Owner: EAttachment

Flags: Read

### The `“icon”` property

      “icon”                     GIcon *

Owner: EAttachment

Flags: Read

### The `“initially-shown”` property

      “initially-shown”          gboolean

Owner: EAttachment

Flags: Read / Write / Construct

Default value: FALSE

### The `“is-possible”` property

      “is-possible”              gboolean

Owner: EAttachment

Flags: Read / Write / Construct

Default value: FALSE

### The `“loading”` property

      “loading”                  gboolean

Owner: EAttachment

Flags: Read

Default value: FALSE

### The `“may-reload”` property

      “may-reload”               gboolean

Owner: EAttachment

Flags: Read / Write / Construct

Default value: FALSE

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

      “mime-part”                CamelMimePart *

Owner: EAttachment

Flags: Read / Write

### The `“percent”` property

      “percent”                  int

Owner: EAttachment

Flags: Read

Allowed values: [0,100]

Default value: 0

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

      “save-extracted”           gboolean

Owner: EAttachment

Flags: Read / Write

Default value: FALSE

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

      “save-self”                gboolean

Owner: EAttachment

Flags: Read / Write

Default value: TRUE

### The `“saving”` property

      “saving”                   gboolean

Owner: EAttachment

Flags: Read

Default value: FALSE

### The `“signed”` property

      “signed”                   int

Owner: EAttachment

Flags: Read / Write / Construct

Allowed values: [0,4]

Default value: 0

## Signal Details

### The `“load-failed”` signal

    void
    user_function (EAttachment *eattachment,
                   gpointer     user_data)

Flags: Run Last

### The `“update-file-info”` signal

    void
    user_function (EAttachment *eattachment,
                   char        *arg1,
                   char        *arg2,
                   char        *arg3,
                   gint64       arg4,
                   gpointer     user_data)

Flags: Run Last

### The `“update-icon”` signal

    void
    user_function (EAttachment *eattachment,
                   GIcon       *arg1,
                   gpointer     user_data)

Flags: Run Last

### The `“update-progress”` signal

    void
    user_function (EAttachment *eattachment,
                   gboolean     arg1,
                   gboolean     arg2,
                   int          arg3,
                   gpointer     user_data)

Flags: Run Last