DXR is a code search and navigation tool aimed at making sense of large projects. It supports full-text and regex searches as well as structural queries.

Mercurial (4b8605e6a17d)

VCS Links

Line Code
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 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150
/* -*- 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 "nsISupports.idl"
#include "nsIMsgCompose.idl"
#include "nsIMsgComposeParams.idl"

interface nsIURI;
interface nsIDocShell;
interface nsIMsgWindow;
interface nsIMsgIdentity;
interface nsIMsgIncomingServer;
interface nsIMsgDBHdr;

[scriptable, uuid(8de65170-a452-11e0-8264-0800200c9a66)]
interface nsIMsgComposeService : nsISupports {

  /* we need a msg window because when we forward inline we may need progress */
  void OpenComposeWindow(in string msgComposeWindowURL,
                         in nsIMsgDBHdr msgHdr,
                         in string originalMsgURI,
                         in MSG_ComposeType type, 
                         in MSG_ComposeFormat format,
                         in nsIMsgIdentity identity, 
                         in nsIMsgWindow aMsgWindow);

  /**
   * Open a compose window given a mailto url and (optionally) an identity.
   *
   * @param aMsgComposeWindowURL Can be null in most cases. If you have your
   *                             own chrome url you want to use in bringing up a
   *                             compose window, pass it in here.
   * @param aURI                 The mailto url you want to use as the
   *                             foundation for the data inside the compose
   *                             window.
   * @param aIdentity            An optional identity to send the message from.
   */
  void OpenComposeWindowWithURI(in string msgComposeWindowURL,
                                in nsIURI aURI,
                                [optional] in nsIMsgIdentity aIdentity);

  /* ... */
  void OpenComposeWindowWithParams(in string msgComposeWindowURL, in nsIMsgComposeParams params);

  /**
   * Creates an nsIMsgCompose instance, initalizes it, and manages the window
   * recycling cache.
   *
   * @param aParams   An nsIMsgComposeParams object containing the initial
   *                  details for the compose.
   * @param aWindow   The optional window associated with this compose object.
   * @param aDocShell The optional docShell of the editor element that is used
   *                  for composing.
   */
  nsIMsgCompose initCompose(in nsIMsgComposeParams aParams,
                            [optional] in nsIDOMWindow aWindow, 
                            [optional] in nsIDocShell aDocShell);

  /**
  * defaultIdentity
  *
  * @return the default identity, in case no identity has been setup yet, will return null
  */
  readonly attribute nsIMsgIdentity defaultIdentity;

  /* This function is use for debugging purpose only and may go away at anytime without warning */
  void TimeStamp(in string label, in boolean resetTime);  
  
  /* This attribute is use for debugging purposes for determining whether to PR_LOG or not */
  readonly attribute boolean logComposePerformance;

  [noscript] boolean determineComposeHTML(in nsIMsgIdentity aIdentity, in MSG_ComposeFormat aFormat);
  [noscript] void cacheWindow(in nsIDOMWindow aWindow, in boolean aComposeHTML, in nsIMsgComposeRecyclingListener listener);
  boolean isCachedWindow(in nsIDOMWindow aWindow);

  /** 
   * given a mailto url, parse the attributes and turn them into a nsIMsgComposeParams object
   * @return nsIMsgComposeParams which corresponds to the passed in mailto url
   */
  nsIMsgComposeParams getParamsForMailto(in nsIURI aURI); 

  /**
   * @{
   * These constants control how to forward messages in forwardMessage.
   * kForwardAsDefault uses value of pref "mail.forward_message_mode".
   */
  const unsigned long kForwardAsDefault = 0;
  const unsigned long kForwardAsAttachment = 1;
  const unsigned long kForwardInline = 2;
  /** @} */

  /**
   * Allow filters to automatically forward a message to the given address(es).
   * @param forwardTo the address(es) to forward to
   * @param msgHdr the header of the message being replied to
   * @param msgWindow message window to use
   * @param server server to use for determining which account to send from
   * @param aForwardType - How to forward the message one of 3 values:
   *                       kForwardAsDefault, kForwardInline, or
   *                       kForwardAsAttachment.
   */
  void forwardMessage(in AString forwardTo, in nsIMsgDBHdr msgHdr,
                      in nsIMsgWindow msgWindow, in nsIMsgIncomingServer server,
                      in unsigned long aForwardType);

  /**
   * Allow filters to automatically reply to a message. The reply message is
   * based on the given template.
   * @param msgHdr the header of the message being replied to
   * @param templateUri uri of the template to base ther reply on
   * @param msgWindow message window to use
   * @param server server to use for determining which account to send from
   */
  void replyWithTemplate(in nsIMsgDBHdr msgHdr, in string templateUri,
                         in nsIMsgWindow msgWindow, in nsIMsgIncomingServer server);

  /** 
   * The docShell of each editor element used for composing should be registered
   * with this service. docShells passed to initCompose get registered
   * automatically. The registrations are typically used to get the msgCompose
   * window when determining what remote content to allow to be displayed.
   *
   * @param aDocShell The nsIDocShell of the editor element. 
   * @param aMsgCompose The compose object associated with the compose window
   */
  void registerComposeDocShell(in nsIDocShell aDocShell,
                               in nsIMsgCompose aMsgCompose);

  /** 
   * When an editor docShell is being closed (or recycled), you should
   * unregister it from this service. nsIMsgCompose normally calls this
   * automatically for items passed to initCompose.
   *
   * @param aDocShell The nsIDocShell of the editor element. 
   */
  void unregisterComposeDocShell(in nsIDocShell aDocShell);
  
  /**
   * For a given docShell, returns the nsIMsgCompose object associated with it.
   *
   * @param aDocShell The nsIDocShell of the editor element. 
   *
   * @return NS_ERROR_FAILURE if we could not find a nsIMsgCompose for
   *         the passed in docShell.
   */
  nsIMsgCompose getMsgComposeForDocShell(in nsIDocShell aDocShell);
};