pjs/mailnews/compose/public/nsIMsgCompose.idl

267 строки
8.8 KiB
Plaintext

/* -*- Mode: idl; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/* ***** BEGIN LICENSE BLOCK *****
* Version: NPL 1.1/GPL 2.0/LGPL 2.1
*
* 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 the Initial Developer are Copyright (C) 1998
* the Initial Developer. All Rights Reserved.
*
* Contributor(s):
*
* Alternatively, the contents of this file may be used under the terms of
* either the GNU General Public License Version 2 or later (the "GPL"), or
* the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
* in which case the provisions of the GPL or the LGPL are applicable instead
* of those above. If you wish to allow use of your version of this file only
* under the terms of either the GPL or the LGPL, and not to allow others to
* use your version of this file under the terms of the NPL, indicate your
* decision by deleting the provisions above and replace them with the notice
* and other provisions required by the GPL or the LGPL. If you do not delete
* the provisions above, a recipient may use your version of this file under
* the terms of any one of the NPL, the GPL or the LGPL.
*
* ***** END LICENSE BLOCK ***** */
#include "nsISupports.idl"
#include "nsIMsgCompFields.idl"
#include "nsIMsgComposeParams.idl"
#include "nsIEditorShell.idl"
#include "nsIMsgIdentity.idl"
#include "nsIMsgSend.idl"
#include "nsIMsgProgress.idl"
%{ C++
#include "nsIEditorShell.h"
%}
interface nsIDOMWindowInternal;
interface nsIDOMNode;
typedef long MSG_ComposeSaveType;
[scriptable, uuid(6953e50a-7531-11d3-85fe-006008948010)]
interface nsIMsgCompSaveType {
const long File = 0;
const long Template = 1;
const long Draft = 2;
};
typedef long MSG_DeliverMode;
[scriptable, uuid(f338eba4-7530-11d3-8833-006008948010)]
interface nsIMsgCompDeliverMode {
const long Now = 0;
const long Later = 1;
const long Save = 2;
const long SaveAs = 3;
const long SaveAsDraft = 4;
const long SaveAsTemplate = 5;
const long SendUnsent = 6;
};
[scriptable, uuid(f38ea280-e090-11d3-a449-e3153319347c)]
interface nsIMsgCompSendFormat {
const long AskUser = 4; /* Hack: Bug 44512. If this is 0 and passed
as results.action to the askSendFormat
dialog, the args object gets destroyed.*/
const long PlainText = 1;
const long HTML = 2;
const long Both = 3;
};
[scriptable, uuid(9638af92-1dd1-11b2-bef1-ca5fee0abc62)]
interface nsIMsgCompConvertible/*ToTXT*/ {
const long Plain = 1; // Like 4.x: Only <html>, <p>, <br>, ...
const long Yes = 2; // *Minor* alterations of the look: <ol>, <dd>, ...
const long Altering = 3; /* Look altered: <strong>, <i>, <h1>, ...
Can be expressed in plaintext, but not in
the way it looked in the HTML composer. */
const long No = 4; /* Will lose data: <font>, ...
Really *requires* visual formatting or
is not supported by our HTML->TXT converter. */
/* The values here have meaning, they are "levels":
convertible({a; b}) == max(convertible({a}), convertible({b}))
must be true, i.e. the higher value counts. */
};
[scriptable, uuid(e72c6981-992a-11d3-a449-eb15bb19bc7c)]
interface nsIMsgComposeStateListener : nsISupports
{
/* ... */
void NotifyComposeFieldsReady();
void ComposeProcessDone(in nsresult aResult);
void SaveInFolderDone(in string folderName);
};
%{ C++
/* TODO: we should create an interface for this enum! */
typedef enum {
eComposeFieldsReady,
eComposeProcessDone,
eSaveInFolderDone
} TStateListenerNotification;
%}
native TStateListenerNotification(TStateListenerNotification);
native nsString(nsString);
[ref] native nsStringRef(nsString);
/* recycling listener interface */
[scriptable, uuid(0b28cc56-1dd2-11b2-bbe4-99e6a314f8ba)]
interface nsIMsgComposeRecyclingListener : nsISupports {
void onClose();
void onReopen(in nsIMsgComposeParams params);
};
[scriptable, uuid(4E606270-B588-11D2-8289-00805F2A0107)]
interface nsIMsgCompose : nsISupports {
/* ... */
void Initialize(in nsIDOMWindowInternal aWindow, in nsIMsgComposeParams aParams);
/* ... */
void SetDocumentCharset(in string charset);
/* ... */
void RegisterStateListener(in nsIMsgComposeStateListener stateListener);
/* ... */
void UnregisterStateListener(in nsIMsgComposeStateListener stateListener);
/* ... */
void SendMsg(in MSG_DeliverMode deliverMode, in nsIMsgIdentity identity, in nsIMsgProgress progress);
/* ... */
void CloseWindow(in boolean reclycleIt);
/* ... */
void abort();
/*
AttachmentPrettyName will return only the leafName if the it's a file URL.
It will also convert the filename to the right character set.
This UI utility function should probably go into it's own class
*/
wstring AttachmentPrettyName(in string url);
/*
CheckAndPopulateRecipients will perform several task:
1) if populateMailList is true, it will populate mailing presents in the compose field
2) if returnNoHTMLRecipients is true, build a list of non HTML recipient
3) return the lowest common format prefered by recipients (unknow, plaintext or html)
*/
unsigned long CheckAndPopulateRecipients(in boolean populateMailList, in boolean returnNonHTMLRecipients, out wstring nonHTMLRecipients);
/* GetNoHtmlNewsgroups: if null is passed as recipient, the function will automatically
looks for newsgroups stored in compose fields
*/
string GetNoHtmlNewsgroups(in string newsgroups);
/* bodyConvertible: The level of "convertibility" to plaintext
* @return a value from nsIMsgCompConvertible.
*/
long bodyConvertible();
/* SetSignature: will replace the curr.
*/
void SetSignature(in nsIMsgIdentity identity);
/* ResetNodeEventHandlers: Temporary API to go around bug 26528. THis API will be removed when bug 26528 is fixed.
*/
void ResetNodeEventHandlers(in nsIDOMNode node);
/* Retreive the message send object */
readonly attribute nsIMsgSend messageSend;
/* ... */
attribute nsIEditorShell editor;
/* ... */
readonly attribute nsIDOMWindowInternal domWindow;
/* ... */
readonly attribute nsIMsgCompFields compFields;
/* ... */
readonly attribute boolean composeHTML;
/* ... */
attribute MSG_ComposeType type;
/* ... */
readonly attribute long wrapLength;
/* by reading this value, you can determine if yes or not the message has been mofified
by the user. When you set this value to false, you reset the modification count
of the body to 0 (clean).
*/
attribute boolean bodyModified;
/* The following functions are for internal use, essentially for the listener */
/* ... */
[noscript] void setCiteReference(in nsString citeReference);
/* Set the URI of the folder where the message has been saved */
[noscript] attribute string savedFolderURI;
/* Append the signature defined in the identity to the msgBody */
[noscript] void processSignature(in nsIMsgIdentity identity, inout nsString aMsgBody);
/* set any reply flags on the original message's folder */
[noscript] void processReplyFlags();
/* ... */
[noscript] void convertAndLoadComposeWindow(in nsIEditorShell aEditorShell, in nsStringRef aPrefix, in nsStringRef aBuf,
in nsStringRef aSignature, in boolean aQuoted, in boolean aHTMLEditor);
/* Tell the doc state listeners that the doc state has changed */
[noscript] void notifyStateListeners(in TStateListenerNotification aNotificationType, in nsresult aResult);
/* Retreive the progress object */
readonly attribute nsIMsgProgress progress;
/* Retreive the external send listener */
nsIMsgSendListener getExternalSendListener();
/* ... */
[noscript] void buildBodyMessageAndSignature();
/* ... */
[noscript] void buildQuotedMessageAndSignature();
/* ... */
[noscript] void getQuotingToFollow(out boolean quotingToFollow);
/* ... */
attribute nsIMsgComposeRecyclingListener recyclingListener;
/* ... */
attribute boolean recycledWindow;
};
/* send listener interface */
[noscript, uuid(ACC72780-2CEA-11D5-9DAA-BACDEAC1EEFC)]
interface nsIMsgComposeSendListener : nsISupports {
void setMsgCompose(in nsIMsgCompose msgCompose);
void setDeliverMode(in MSG_DeliverMode deliverMode);
};