widget/nsIDragSession.idl

   1 /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
   2  *
   3  * This Source Code Form is subject to the terms of the Mozilla Public
   4  * License, v. 2.0. If a copy of the MPL was not distributed with this
   5  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
   6
   7 #include "nsISupports.idl"
   8 #include "nsITransferable.idl"
   9
  10
  11
  12 %{ C++
  13 #include "nsSize.h"
  14 %}
  15 interface nsIContentSecurityPolicy;
  16
  17 native nsSize(nsSize);
  18
  19 webidl DataTransfer;
  20 webidl Document;
  21 webidl Node;
  22
  23 [scriptable, builtinclass, uuid(25bce737-73f0-43c7-bc20-c71044a73c5a)]
  24 interface nsIDragSession : nsISupports
  25 {
  26   /**
  27     * Set the current state of the drag, whether it can be dropped or not.
  28     * usually the target "frame" sets this so the native system can render the correct feedback
  29     */
  30   attribute boolean canDrop;
  31
  32   /**
  33    * Indicates if the drop event should be dispatched only to chrome.
  34    */
  35   attribute boolean onlyChromeDrop;
  36
  37   /**
  38     * Sets the action (copy, move, link, et.c) for the current drag
  39     */
  40   attribute unsigned long dragAction;
  41
  42   /**
  43     * Get the number of items that were dropped
  44     */
  45   readonly attribute unsigned long numDropItems;
  46
  47   /**
  48     * The document where the drag was started, which will be null if the
  49     * drag originated outside the application. Useful for determining if a drop
  50     * originated in the same document.
  51     */
  52   [infallible]
  53   readonly attribute Document sourceDocument;
  54
  55   /**
  56     * The dom node that was originally dragged to start the session, which will be null if the
  57     * drag originated outside the application.
  58     */
  59   readonly attribute Node sourceNode;
  60
  61   /**
  62    * the triggering principal.  This may be different than sourceNode's
  63    * principal when sourceNode is xul:browser and the drag is
  64    * triggered in a browsing context inside it.
  65    */
  66   attribute nsIPrincipal triggeringPrincipal;
  67
  68   /**
  69    * the triggering csp.  This may be different than sourceNode's
  70    * csp when sourceNode is xul:browser and the drag is
  71    * triggered in a browsing context inside it.
  72    */
  73   attribute nsIContentSecurityPolicy csp;
  74
  75   /**
  76    * The data transfer object for the current drag.
  77    */
  78   [binaryname(DataTransferXPCOM)]
  79   attribute DataTransfer dataTransfer;
  80   [notxpcom, nostdcall] DataTransfer getDataTransfer();
  81   [notxpcom, nostdcall] void setDataTransfer(in DataTransfer aDataTransfer);
  82
  83   /**
  84     * Get data from a Drag&Drop. Can be called while the drag is in process
  85     * or after the drop has completed.
  86     *
  87     * @param  aTransferable the transferable for the data to be put into
  88     * @param  aItemIndex which of multiple drag items, zero-based
  89     */
  90   void getData ( in nsITransferable aTransferable, in unsigned long aItemIndex ) ;
  91
  92    /**
  93     * Check to set if any of the native data on the clipboard matches this data flavor
  94     */
  95   boolean isDataFlavorSupported ( in string aDataFlavor ) ;
  96
  97   void userCancelled();
  98
  99   void dragEventDispatchedToChildProcess();
 100
 101   // Called when nsIDragSession implementation should update the UI for the
 102   // drag-and-drop based on the data got from the child process in response to
 103   // NS_DRAGDROP_OVER sent from parent process to child process.
 104   void updateDragEffect();
 105
 106   // Change the drag image, using similar arguments as
 107   // nsIDragService::InvokeDragSessionWithImage.
 108   void updateDragImage(in Node aImage, in long aImageX, in long aImageY);
 109
 110   /**
 111    * Returns effects allowed at starting the session for tests.
 112    */
 113   [notxpcom, nostdcall] unsigned long getEffectAllowedForTests();
 114
 115   /**
 116    * Returns true if current session was started with synthesized drag start.
 117    */
 118   [notxpcom, nostdcall] bool isSynthesizedForTests();
 119
 120   /**
 121    * Sets drag end point of synthesized session when the test does not dispatch
 122    * "drop" event.
 123    */
 124   void setDragEndPointForTests(in long aScreenX, in long aScreenY);
 125 };