Sample code for 30+ languages & platforms
Android™

Get IMAP Attachment Filenames

See more IMAP Examples

Demonstrates the Chilkat Imap.GetMailAttachFilename method, which returns the filename of an attachment. The first argument is the Email and the second is the zero-based attachment index. This example fetches only the message headers and lists the attachment filenames.

Background: This method reads the filename from ckx-imap-* metadata, so it works on a header-only email even though the attachment bodies have not been downloaded. That is exactly what a mail client needs to render the paperclip list — the names of the attached files — before the user decides to download any of them.

Chilkat Android™ Downloads

Android™
// Important: Don't forget to include the call to System.loadLibrary
// as shown at the bottom of this code sample.
package com.test;

import android.app.Activity;
import com.chilkatsoft.*;

import android.widget.TextView;
import android.os.Bundle;

public class SimpleActivity extends Activity {

  private static final String TAG = "Chilkat";

  // Called when the activity is first created.
  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    boolean success = false;

    //  Demonstrates the Imap.GetMailAttachFilename method, which returns the filename of an
    //  attachment.  The 1st argument is the Email and the 2nd is the zero-based attachment index.

    CkImap imap = new CkImap();

    imap.put_Ssl(true);
    imap.put_Port(993);

    success = imap.Connect("imap.example.com");
    if (success == false) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    success = imap.Login("user@example.com","myPassword");
    if (success == false) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    success = imap.SelectMailbox("Inbox");
    if (success == false) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    //  Fetch only the message headers.  Attachment bodies are NOT downloaded, but the ckx-imap-*
    //  metadata describing the attachments is present, so the attachment info methods still work.
    boolean headersOnly = true;
    boolean useUid = false;
    int seqNum = 1;
    CkEmail email = new CkEmail();
    success = imap.FetchEmail(headersOnly,seqNum,useUid,email);
    if (success == false) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }

    //  Loop over the attachments and print each filename.
    int numAttach = imap.GetMailNumAttach(email);
    Log.i(TAG, "Attachments: " + String.valueOf(numAttach));
    int i;
    for (i = 0; i <= numAttach - 1; i++) {
        //  GetMailAttachFilename returns a string, so assign it to a string variable.
        String fname = imap.getMailAttachFilename(email,i);
        if (imap.get_LastMethodSuccess() == false) {
            Log.i(TAG, imap.lastErrorText());
            return;
            }

        Log.i(TAG, fname);
        }

    success = imap.Disconnect();
    if (success == false) {
        Log.i(TAG, imap.lastErrorText());
        return;
        }


  }

  static {
      System.loadLibrary("chilkat");

      // Note: If the incorrect library name is passed to System.loadLibrary,
      // then you will see the following error message at application startup:
      //"The application <your-application-name> has stopped unexpectedly. Please try again."
  }
}