summaryrefslogtreecommitdiffstats
path: root/comm/mailnews/compose/public/nsIMsgCompFields.idl
blob: 7ed51f47375fb9dd68905533f517f1a9b356ef81 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "msgIStructuredHeaders.idl"

interface nsIMsgAttachment;
interface nsIMsgComposeSecure;

/**
 * A collection of headers and other attributes for building a mail message.
 */
[scriptable, uuid(10928477-4F24-4357-9397-FBD847F46F0A)]
interface nsIMsgCompFields : msgIWritableStructuredHeaders {

  attribute AString from;
  attribute AString replyTo;
  attribute AString to;
  attribute AString cc;
  attribute AString bcc;
  readonly attribute bool hasRecipients;

  attribute AString fcc;
  attribute AString fcc2;

  attribute AString newsgroups;
  attribute string  newspostUrl;
  attribute AString followupTo;

  attribute AString subject;

  attribute AString organization;
  attribute string  references;
  attribute string  priority;
  attribute string  messageId;

  attribute AString templateName;
  // The so-called draft/template ID is a URI in reality.
  attribute AUTF8String draftId;
  attribute AUTF8String templateId;

  attribute boolean returnReceipt;
  attribute long receiptHeaderType;
  attribute boolean DSN;
  attribute boolean attachVCard;
  attribute boolean forcePlainText;
  attribute boolean useMultipartAlternative;
  attribute boolean bodyIsAsciiOnly;
  attribute boolean forceMsgEncoding;
  /// Status of manually-activated attachment reminder.
  attribute boolean attachmentReminder;
  /// Delivery format for the mail being composed
  /// (auto = 4, text = 1, html = 2, text and html = 3).
  attribute long deliveryFormat;
  attribute string contentLanguage;
  /// This is populated with the key of the identity which created the draft or template.
  attribute string creatorIdentityKey;

  /**
   * Beware that when setting this property, your body must be properly wrapped,
   * and the line endings must match MSG_LINEBREAK, namely "\r\n" on Windows
   * and "\n" on Linux and OSX.
   */
  attribute AString body;

  readonly attribute Array<nsIMsgAttachment> attachments;
  void addAttachment(in nsIMsgAttachment attachment);
  void removeAttachment(in nsIMsgAttachment attachment);
  void removeAttachments();

  /**
   * Values for other headers. Headers in order, from the
   * mail.compose.other.header pref.
   */
  attribute Array<AString> otherHeaders;

  /**
   * This function will split the recipients into an array.
   *
   * @param aRecipients       The recipients list to split.
   * @param aEmailAddressOnly Set to true to drop display names from the results
   *                          array.
   *
   * @return An array of the recipients.
   */
  Array<AString> splitRecipients(in AString aRecipients,
                                 in boolean aEmailAddressOnly);

  void ConvertBodyToPlainText();

  /**
   * Indicates whether we need to check if the current |DocumentCharset|
   * can represent all the characters in the message body. It should be
   * initialized to true and set to false when 'Send Anyway' is selected
   * by a user. (bug 249530)
   */
  attribute boolean needToCheckCharset;

  /**
   * Object implementing encryption/signing functionality (e.g. S/MIME, PGP/MIME)
   */
  attribute nsIMsgComposeSecure composeSecure;
};