(Android™) Explaining the Email FromName, FromAddress, and From Properties

This example explains the email object's FromName, FromAddress, and From properties.

Chilkat Android™ Downloads Android™ Java Libraries Android C/C++ Libraries

// 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);

    // The email's FROM name and address can be set in several ways.
    // It can include an optional friendly name (which is just a description),
    // and it must include an address.

    // For example:
    CkEmail email1 = new CkEmail();
    email1.put_Subject("test");
    email1.put_Body("test");

    email1.put_FromName("Joe Sample");
    email1.put_FromAddress("joe.sample@example.com");

    // the From property contains both the FromName and FromAddress
    // This produces the following output:
    // From: "Joe Sample" <joe.sample@example.com>
    Log.i(TAG, "From: " + email1.ck_from());
    Log.i(TAG, "--------------------------------------------------");

    // Examine the MIME of the email:
    Log.i(TAG, email1.getMime());
    Log.i(TAG, "--------------------------------------------------");

    // Output is:

    // 	MIME-Version: 1.0
    // 	Date: Wed, 16 Nov 2016 12:32:13 -0600
    // 	Message-ID: <02B461C6D12FA6686C3151A649ED8D5BBFBE0721@CHILKAT13>
    // 	Content-Type: text/plain
    // 	Content-Transfer-Encoding: 7bit
    // 	X-Priority: 3 (Normal)
    // 	Subject: test
    // 	From: "Joe Sample" <joe.sample@example.com>
    // 	CKX-Bounce-Address: joe.sample@example.com
    // 
    // 	test

    // --------------------------------------------
    // Alternatively, the From property can be set, and this 
    // implicitly sets the FromName and FromAddress properties.

    CkEmail email2 = new CkEmail();
    email2.put_From("Joe Sample <joe.sample@example.com>");

    Log.i(TAG, "FromName: " + email2.fromName());
    Log.i(TAG, "FromAddress: " + email2.fromAddress());
    Log.i(TAG, "--------------------------------------------------");

    Log.i(TAG, email2.getMime());

  }

  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."
  }
}