Dart

Remove the Plain-Text Body from an Email

Demonstrates the Chilkat Email.RemovePlainTextAlternative method, which removes the plain-text body from the email if one exists. Other body representations, attachments, and related items remain unchanged. This example builds a message with both plain-text and HTML alternatives, then removes the plain text.

Background: This is the counterpart to RemoveHtmlAlternative. Removing the plain-text alternative leaves an HTML-only message. Note that dropping the plain-text fallback is generally discouraged for real mail — it hurts accessibility and can raise spam scores — but it is occasionally needed when a downstream system expects a single HTML representation.

Chilkat Dart Downloads

Download Chilkat for Dart

Dart

import 'package:chilkat/chilkat.dart';

void main() {
  // Demonstrates the RemovePlainTextAlternative method, which removes the plain-text body
  // from the email (if one exists).  Other body representations, attachments, and related
  // items remain.

  final email = CkEmail();
  email.subject = 'Remove plain-text alternative';

  // Create an email with both plain-text and HTML alternatives.
  email.setTextBody('This is the plain-text version.', 'text/plain');
  email.addHtmlAlternativeBody('<html><body>This is the HTML version.</body></html>');
  print('NumAlternatives before = ${email.numAlternatives}');
  print('HasPlainTextBody before: ${email.hasPlainTextBody()}');

  // Remove the plain-text body, leaving the HTML alternative.
  email.removePlainTextAlternative();
  print('NumAlternatives after = ${email.numAlternatives}');
  print('HasPlainTextBody after: ${email.hasPlainTextBody()}');
}