gecko-dev/mailnews/compose/public/nsIMsgComposeService.idl

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 2 -*-
 *
 * The contents of this file are subject to the Netscape Public
 * License Version 1.1 (the "License"); you may not use this file
 * except in compliance with the License. You may obtain a copy of
 * the License at http://www.mozilla.org/NPL/
 *
 * Software distributed under the License is distributed on an "AS
 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
 * implied. See the License for the specific language governing
 * rights and limitations under the License.
 *
 * The Original Code is mozilla.org code.
 *
 * The Initial Developer of the Original Code is Netscape
 * Communications Corporation.  Portions created by Netscape are
 * Copyright (C) 1998 Netscape Communications Corporation. All
 * Rights Reserved.
 *
 * Contributor(s): 
*/


#include "nsISupports.idl"
#include "nsIMsgCompose.idl"
#include "nsIMsgComposeParams.idl"
#include "nsIMsgIdentity.idl"

interface nsIURI;
interface nsIDOMWindowInternal;


[scriptable, uuid(B004F4AE-1AC2-11d3-A715-0060B0EB39B5)]
interface nsIMsgComposeService : nsISupports {

	/* ... */
	void OpenComposeWindow(in string msgComposeWindowURL, in string originalMsgURI, in MSG_ComposeType type, in MSG_ComposeFormat format,
						   in nsIMsgIdentity identity);

    /* use this method to invoke a compose window given a mailto url.
	   aMsgComposeWindowURL --> can be null in most cases. If you have your own chrome
	   url you want to use in brining up a compose window, pass it in here. 
	   aURI --> the mailto url you want to use as the foundation for the data inside
	   the compose window  */
	void OpenComposeWindowWithURI(in string msgComposeWindowURL, in nsIURI aURI);

	/* ... */
	void OpenComposeWindowWithValues(in string msgComposeWindowURL, in MSG_ComposeType type, in MSG_ComposeFormat format,
							in wstring to, in wstring cc, in wstring bcc, in string newsgroups,
							in wstring subject, in wstring body, in string attachment, in nsIMsgIdentity identity);

	/* ... */
	void OpenComposeWindowWithCompFields(in string msgComposeWindowURL, in MSG_ComposeType type, in MSG_ComposeFormat format,
										in nsIMsgCompFields compFields, in nsIMsgIdentity identity);

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

	/* ... */
	nsIMsgCompose InitCompose(in nsIDOMWindowInternal aWindow, in nsIMsgComposeParams params);

 	/* This function is use for debugging purpose only and may go away at anytime without warning */
 	void TimeStamp(in string label, in boolean resetTime);	
};