Back to index

lightning-sunbird  0.9+nobinonly
nsContentAreaDragDrop.h
Go to the documentation of this file.
00001 /* ***** BEGIN LICENSE BLOCK *****
00002  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
00003  *
00004  * The contents of this file are subject to the Mozilla Public License Version
00005  * 1.1 (the "License"); you may not use this file except in compliance with
00006  * the License. You may obtain a copy of the License at
00007  * http://www.mozilla.org/MPL/
00008  *
00009  * Software distributed under the License is distributed on an "AS IS" basis,
00010  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
00011  * for the specific language governing rights and limitations under the
00012  * License.
00013  *
00014  * The Original Code is Mozilla Communicator.
00015  *
00016  * The Initial Developer of the Original Code is
00017  * Netscape Communications.
00018  * Portions created by the Initial Developer are Copyright (C) 2002
00019  * the Initial Developer. All Rights Reserved.
00020  *
00021  * Contributor(s):
00022  *  Mike Pinkerton <pinkerton@netscape.com>
00023  *
00024  * Alternatively, the contents of this file may be used under the terms of
00025  * either the GNU General Public License Version 2 or later (the "GPL"), or
00026  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
00027  * in which case the provisions of the GPL or the LGPL are applicable instead
00028  * of those above. If you wish to allow use of your version of this file only
00029  * under the terms of either the GPL or the LGPL, and not to allow others to
00030  * use your version of this file under the terms of the MPL, indicate your
00031  * decision by deleting the provisions above and replace them with the notice
00032  * and other provisions required by the GPL or the LGPL. If you do not delete
00033  * the provisions above, a recipient may use your version of this file under
00034  * the terms of any one of the MPL, the GPL or the LGPL.
00035  *
00036  * ***** END LICENSE BLOCK ***** */
00037 
00038 
00039 #ifndef nsContentAreaDragDrop_h__
00040 #define nsContentAreaDragDrop_h__
00041 
00042 
00043 #include "nsCOMPtr.h"
00044 
00045 #include "nsIDragDropHandler.h"
00046 #include "nsIDOMDragListener.h"
00047 #include "nsIDOMEventReceiver.h"
00048 #include "nsITransferable.h"
00049 
00050 class nsIDOMNode;
00051 class nsISelection;
00052 class nsITransferable;
00053 class nsIImage;
00054 class nsIPresShell;
00055 class nsPresContext;
00056 class nsIContent;
00057 class nsIDocument;
00058 class nsIURI;
00059 class nsIFile;
00060 class nsISimpleEnumerator;
00061 
00062 // {1f34bc80-1bc7-11d6-a384-d705dd0746fc}
00063 #define NS_CONTENTAREADRAGDROP_CID             \
00064 { 0x1f34bc80, 0x1bc7, 0x11d6, \
00065   { 0xa3, 0x84, 0xd7, 0x05, 0xdd, 0x07, 0x46, 0xfc } }
00066 
00067 #define NS_CONTENTAREADRAGDROP_CONTRACTID "@mozilla.org:/content/content-area-dragdrop;1"
00068 
00069 
00070 //
00071 // class nsContentAreaDragDrop
00072 //
00073 // The class that listens to the chrome events handles anything
00074 // related to drag and drop. Registers itself with the DOM with
00075 // AddChromeListeners() and removes itself with
00076 // RemoveChromeListeners().
00077 //
00078 class nsContentAreaDragDrop : public nsIDOMDragListener,
00079                               public nsIDragDropHandler,
00080                               public nsIFlavorDataProvider
00081 {
00082 public:
00083   NS_DECL_ISUPPORTS
00084   NS_DECL_NSIDRAGDROPHANDLER
00085   NS_DECL_NSIFLAVORDATAPROVIDER
00086   
00087   nsContentAreaDragDrop();
00088   virtual ~nsContentAreaDragDrop();
00089 
00090   // nsIDOMDragListener
00091   NS_IMETHOD DragEnter(nsIDOMEvent* aMouseEvent);
00092   NS_IMETHOD DragOver(nsIDOMEvent* aMouseEvent);
00093   NS_IMETHOD DragExit(nsIDOMEvent* aMouseEvent);
00094   NS_IMETHOD DragDrop(nsIDOMEvent* aMouseEvent);
00095   NS_IMETHOD DragGesture(nsIDOMEvent* aMouseEvent);
00096   NS_IMETHOD HandleEvent(nsIDOMEvent *event);
00097 
00098 private:
00099 
00100   // Add/remove the relevant listeners
00101   nsresult AddDragListener();
00102   nsresult RemoveDragListener();
00103 
00104   // utility routines
00105   static void NormalizeSelection(nsIDOMNode* inBaseNode,
00106                                  nsISelection* inSelection);
00107   static void GetEventDocument(nsIDOMEvent* inEvent,
00108                                nsIDOMDocument** outDocument);
00109 
00110   static nsresult SaveURIToFile(nsAString& inSourceURIString,
00111                                 nsIFile* inDestFile);
00112   
00113   nsresult CreateTransferable(nsIDOMEvent* inMouseEvent,
00114                               nsITransferable** outTrans);
00115   void ExtractURLFromData(const nsACString & inFlavor,
00116                           nsISupports* inDataWrapper, PRUint32 inDataLen,
00117                           nsAString & outURL);
00118   nsresult GetHookEnumeratorFromEvent(nsIDOMEvent* inEvent,
00119                                       nsISimpleEnumerator** outEnumerator);
00120 
00121   PRPackedBool mListenerInstalled;
00122 
00123   nsCOMPtr<nsIDOMEventReceiver> mEventReceiver;
00124 
00125   // weak ref, this is probably my owning webshell
00126   nsIWebNavigation* mNavigator;
00127 
00128 };
00129 
00130 
00131 
00132 #endif /* nsContentAreaDragDrop_h__ */
00133