Upgrade to ExtJS 4.0.7 - Released 10/19/2011
[extjs.git] / docs / source / DragDropManager.html
index 23148b1..2eb09db 100644 (file)
@@ -1,4 +1,21 @@
-<!DOCTYPE html><html><head><title>Sencha Documentation Project</title><link rel="stylesheet" href="../reset.css" type="text/css"><link rel="stylesheet" href="../prettify.css" type="text/css"><link rel="stylesheet" href="../prettify_sa.css" type="text/css"><script type="text/javascript" src="../prettify.js"></script></head><body onload="prettyPrint()"><pre class="prettyprint"><pre>/*
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+  <title>The source code</title>
+  <link href="../resources/prettify/prettify.css" type="text/css" rel="stylesheet" />
+  <script type="text/javascript" src="../resources/prettify/prettify.js"></script>
+  <style type="text/css">
+    .highlight { display: block; background-color: #ddd; }
+  </style>
+  <script type="text/javascript">
+    function highlight() {
+      document.getElementById(location.hash.replace(/#/, "")).className = "highlight";
+    }
+  </script>
+</head>
+<body onload="prettyPrint(); highlight();">
+  <pre class="prettyprint lang-js">/*
  * This is a derivative of the similarly named class in the YUI Library.
  * The original license:
  * Copyright (c) 2006, Yahoo! Inc. All rights reserved.
@@ -7,7 +24,7 @@
  */
 
 
-<span id='Ext-dd.DragDropManager'>/**
+<span id='Ext-dd-DragDropManager'>/**
 </span> * @class Ext.dd.DragDropManager
  * DragDropManager is a singleton that tracks the element interaction for
  * all DragDrop items in the window.  Generally, you will not call
@@ -24,144 +41,127 @@ Ext.define('Ext.dd.DragDropManager', {
 
     // shorter ClassName, to save bytes and use internally
     alternateClassName: ['Ext.dd.DragDropMgr', 'Ext.dd.DDM'],
-    
-<span id='Ext-dd.DragDropManager-property-ids'>    /**
+
+<span id='Ext-dd-DragDropManager-property-ids'>    /**
 </span>     * Two dimensional Array of registered DragDrop objects.  The first
      * dimension is the DragDrop item group, the second the DragDrop
      * object.
      * @property ids
      * @type String[]
      * @private
-     * @static
      */
     ids: {},
 
-<span id='Ext-dd.DragDropManager-property-handleIds'>    /**
+<span id='Ext-dd-DragDropManager-property-handleIds'>    /**
 </span>     * Array of element ids defined as drag handles.  Used to determine
      * if the element that generated the mousedown event is actually the
      * handle and not the html element itself.
      * @property handleIds
      * @type String[]
      * @private
-     * @static
      */
     handleIds: {},
 
-<span id='Ext-dd.DragDropManager-property-dragCurrent'>    /**
+<span id='Ext-dd-DragDropManager-property-dragCurrent'>    /**
 </span>     * the DragDrop object that is currently being dragged
-     * @property dragCurrent
-     * @type DragDrop
+     * @property {Ext.dd.DragDrop} dragCurrent
      * @private
-     * @static
      **/
     dragCurrent: null,
 
-<span id='Ext-dd.DragDropManager-property-dragOvers'>    /**
+<span id='Ext-dd-DragDropManager-property-dragOvers'>    /**
 </span>     * the DragDrop object(s) that are being hovered over
-     * @property dragOvers
-     * @type Array
+     * @property {Ext.dd.DragDrop[]} dragOvers
      * @private
-     * @static
      */
     dragOvers: {},
 
-<span id='Ext-dd.DragDropManager-property-deltaX'>    /**
+<span id='Ext-dd-DragDropManager-property-deltaX'>    /**
 </span>     * the X distance between the cursor and the object being dragged
      * @property deltaX
-     * @type int
+     * @type Number
      * @private
-     * @static
      */
     deltaX: 0,
 
-<span id='Ext-dd.DragDropManager-property-deltaY'>    /**
+<span id='Ext-dd-DragDropManager-property-deltaY'>    /**
 </span>     * the Y distance between the cursor and the object being dragged
      * @property deltaY
-     * @type int
+     * @type Number
      * @private
-     * @static
      */
     deltaY: 0,
 
-<span id='Ext-dd.DragDropManager-property-preventDefault'>    /**
+<span id='Ext-dd-DragDropManager-property-preventDefault'>    /**
 </span>     * Flag to determine if we should prevent the default behavior of the
      * events we define. By default this is true, but this can be set to
      * false if you need the default behavior (not recommended)
      * @property preventDefault
-     * @type boolean
-     * @static
+     * @type Boolean
      */
     preventDefault: true,
 
-<span id='Ext-dd.DragDropManager-property-stopPropagation'>    /**
+<span id='Ext-dd-DragDropManager-property-stopPropagation'>    /**
 </span>     * Flag to determine if we should stop the propagation of the events
      * we generate. This is true by default but you may want to set it to
      * false if the html element contains other features that require the
      * mouse click.
      * @property stopPropagation
-     * @type boolean
-     * @static
+     * @type Boolean
      */
     stopPropagation: true,
 
-<span id='Ext-dd.DragDropManager-property-initialized'>    /**
+<span id='Ext-dd-DragDropManager-property-initialized'>    /**
 </span>     * Internal flag that is set to true when drag and drop has been
      * intialized
      * @property initialized
      * @private
-     * @static
      */
     initialized: false,
 
-<span id='Ext-dd.DragDropManager-property-locked'>    /**
+<span id='Ext-dd-DragDropManager-property-locked'>    /**
 </span>     * All drag and drop can be disabled.
      * @property locked
      * @private
-     * @static
      */
     locked: false,
 
-<span id='Ext-dd.DragDropManager-method-init'>    /**
+<span id='Ext-dd-DragDropManager-method-init'>    /**
 </span>     * Called the first time an element is registered.
      * @method init
      * @private
-     * @static
      */
     init: function() {
         this.initialized = true;
     },
 
-<span id='Ext-dd.DragDropManager-property-POINT'>    /**
+<span id='Ext-dd-DragDropManager-property-POINT'>    /**
 </span>     * In point mode, drag and drop interaction is defined by the
      * location of the cursor during the drag/drop
      * @property POINT
-     * @type int
-     * @static
+     * @type Number
      */
     POINT: 0,
 
-<span id='Ext-dd.DragDropManager-property-INTERSECT'>    /**
+<span id='Ext-dd-DragDropManager-property-INTERSECT'>    /**
 </span>     * In intersect mode, drag and drop interaction is defined by the
      * overlap of two or more drag and drop objects.
      * @property INTERSECT
-     * @type int
-     * @static
+     * @type Number
      */
     INTERSECT: 1,
 
-<span id='Ext-dd.DragDropManager-property-mode'>    /**
+<span id='Ext-dd-DragDropManager-property-mode'>    /**
 </span>     * The current drag and drop mode.  Default: POINT
      * @property mode
-     * @type int
-     * @static
+     * @type Number
      */
     mode: 0,
 
-<span id='Ext-dd.DragDropManager-method-_execOnAll'>    /**
+<span id='Ext-dd-DragDropManager-method-_execOnAll'>    /**
 </span>     * Runs method on all drag and drop objects
      * @method _execOnAll
      * @private
-     * @static
      */
     _execOnAll: function(sMethod, args) {
         for (var i in this.ids) {
@@ -175,11 +175,10 @@ Ext.define('Ext.dd.DragDropManager', {
         }
     },
 
-<span id='Ext-dd.DragDropManager-method-_onLoad'>    /**
+<span id='Ext-dd-DragDropManager-method-_onLoad'>    /**
 </span>     * Drag and drop initialization.  Sets up the global event handlers
      * @method _onLoad
      * @private
-     * @static
      */
     _onLoad: function() {
 
@@ -194,120 +193,107 @@ Ext.define('Ext.dd.DragDropManager', {
 
     },
 
-<span id='Ext-dd.DragDropManager-method-_onResize'>    /**
+<span id='Ext-dd-DragDropManager-method-_onResize'>    /**
 </span>     * Reset constraints on all drag and drop objs
      * @method _onResize
      * @private
-     * @static
      */
     _onResize: function(e) {
         this._execOnAll(&quot;resetConstraints&quot;, []);
     },
 
-<span id='Ext-dd.DragDropManager-method-lock'>    /**
+<span id='Ext-dd-DragDropManager-method-lock'>    /**
 </span>     * Lock all drag and drop functionality
      * @method lock
-     * @static
      */
     lock: function() { this.locked = true; },
 
-<span id='Ext-dd.DragDropManager-method-unlock'>    /**
+<span id='Ext-dd-DragDropManager-method-unlock'>    /**
 </span>     * Unlock all drag and drop functionality
      * @method unlock
-     * @static
      */
     unlock: function() { this.locked = false; },
 
-<span id='Ext-dd.DragDropManager-method-isLocked'>    /**
+<span id='Ext-dd-DragDropManager-method-isLocked'>    /**
 </span>     * Is drag and drop locked?
      * @method isLocked
-     * @return {boolean} True if drag and drop is locked, false otherwise.
-     * @static
+     * @return {Boolean} True if drag and drop is locked, false otherwise.
      */
     isLocked: function() { return this.locked; },
 
-<span id='Ext-dd.DragDropManager-property-locationCache'>    /**
+<span id='Ext-dd-DragDropManager-property-locationCache'>    /**
 </span>     * Location cache that is set for all drag drop objects when a drag is
      * initiated, cleared when the drag is finished.
      * @property locationCache
      * @private
-     * @static
      */
     locationCache: {},
 
-<span id='Ext-dd.DragDropManager-property-useCache'>    /**
+<span id='Ext-dd-DragDropManager-property-useCache'>    /**
 </span>     * Set useCache to false if you want to force object the lookup of each
      * drag and drop linked element constantly during a drag.
      * @property useCache
-     * @type boolean
-     * @static
+     * @type Boolean
      */
     useCache: true,
 
-<span id='Ext-dd.DragDropManager-property-clickPixelThresh'>    /**
+<span id='Ext-dd-DragDropManager-property-clickPixelThresh'>    /**
 </span>     * The number of pixels that the mouse needs to move after the
      * mousedown before the drag is initiated.  Default=3;
      * @property clickPixelThresh
-     * @type int
-     * @static
+     * @type Number
      */
     clickPixelThresh: 3,
 
-<span id='Ext-dd.DragDropManager-property-clickTimeThresh'>    /**
+<span id='Ext-dd-DragDropManager-property-clickTimeThresh'>    /**
 </span>     * The number of milliseconds after the mousedown event to initiate the
      * drag if we don't get a mouseup event. Default=350
      * @property clickTimeThresh
-     * @type int
-     * @static
+     * @type Number
      */
     clickTimeThresh: 350,
 
-<span id='Ext-dd.DragDropManager-property-dragThreshMet'>    /**
+<span id='Ext-dd-DragDropManager-property-dragThreshMet'>    /**
 </span>     * Flag that indicates that either the drag pixel threshold or the
      * mousdown time threshold has been met
      * @property dragThreshMet
-     * @type boolean
+     * @type Boolean
      * @private
-     * @static
      */
     dragThreshMet: false,
 
-<span id='Ext-dd.DragDropManager-property-clickTimeout'>    /**
+<span id='Ext-dd-DragDropManager-property-clickTimeout'>    /**
 </span>     * Timeout used for the click time threshold
      * @property clickTimeout
      * @type Object
      * @private
-     * @static
      */
     clickTimeout: null,
 
-<span id='Ext-dd.DragDropManager-property-startX'>    /**
+<span id='Ext-dd-DragDropManager-property-startX'>    /**
 </span>     * The X position of the mousedown event stored for later use when a
      * drag threshold is met.
      * @property startX
-     * @type int
+     * @type Number
      * @private
-     * @static
      */
     startX: 0,
 
-<span id='Ext-dd.DragDropManager-property-startY'>    /**
+<span id='Ext-dd-DragDropManager-property-startY'>    /**
 </span>     * The Y position of the mousedown event stored for later use when a
      * drag threshold is met.
      * @property startY
-     * @type int
+     * @type Number
      * @private
-     * @static
      */
     startY: 0,
 
-<span id='Ext-dd.DragDropManager-method-regDragDrop'>    /**
+<span id='Ext-dd-DragDropManager-method-regDragDrop'>    /**
 </span>     * Each DragDrop instance must be registered with the DragDropManager.
      * This is executed in DragDrop.init()
      * @method regDragDrop
-     * @param {DragDrop} oDD the DragDrop object to register
+     * @param {Ext.dd.DragDrop} oDD the DragDrop object to register
      * @param {String} sGroup the name of the group this element belongs to
-     * @static
      */
     regDragDrop: function(oDD, sGroup) {
         if (!this.initialized) { this.init(); }
@@ -318,12 +304,11 @@ Ext.define('Ext.dd.DragDropManager', {
         this.ids[sGroup][oDD.id] = oDD;
     },
 
-<span id='Ext-dd.DragDropManager-method-removeDDFromGroup'>    /**
+<span id='Ext-dd-DragDropManager-method-removeDDFromGroup'>    /**
 </span>     * Removes the supplied dd instance from the supplied group. Executed
      * by DragDrop.removeFromGroup, so don't call this function directly.
      * @method removeDDFromGroup
      * @private
-     * @static
      */
     removeDDFromGroup: function(oDD, sGroup) {
         if (!this.ids[sGroup]) {
@@ -336,12 +321,11 @@ Ext.define('Ext.dd.DragDropManager', {
         }
     },
 
-<span id='Ext-dd.DragDropManager-method-_remove'>    /**
+<span id='Ext-dd-DragDropManager-method-_remove'>    /**
 </span>     * Unregisters a drag and drop item.  This is executed in
      * DragDrop.unreg, use that method instead of calling this directly.
      * @method _remove
      * @private
-     * @static
      */
     _remove: function(oDD) {
         for (var g in oDD.groups) {
@@ -352,14 +336,13 @@ Ext.define('Ext.dd.DragDropManager', {
         delete this.handleIds[oDD.id];
     },
 
-<span id='Ext-dd.DragDropManager-method-regHandle'>    /**
+<span id='Ext-dd-DragDropManager-method-regHandle'>    /**
 </span>     * Each DragDrop handle element must be registered.  This is done
      * automatically when executing DragDrop.setHandleElId()
      * @method regHandle
      * @param {String} sDDId the DragDrop id this element is a handle for
      * @param {String} sHandleId the id of the element that is the drag
      * handle
-     * @static
      */
     regHandle: function(sDDId, sHandleId) {
         if (!this.handleIds[sDDId]) {
@@ -368,27 +351,25 @@ Ext.define('Ext.dd.DragDropManager', {
         this.handleIds[sDDId][sHandleId] = sHandleId;
     },
 
-<span id='Ext-dd.DragDropManager-method-isDragDrop'>    /**
+<span id='Ext-dd-DragDropManager-method-isDragDrop'>    /**
 </span>     * Utility function to determine if a given element has been
      * registered as a drag drop item.
      * @method isDragDrop
      * @param {String} id the element id to check
-     * @return {boolean} true if this element is a DragDrop item,
+     * @return {Boolean} true if this element is a DragDrop item,
      * false otherwise
-     * @static
      */
     isDragDrop: function(id) {
         return ( this.getDDById(id) ) ? true : false;
     },
 
-<span id='Ext-dd.DragDropManager-method-getRelated'>    /**
+<span id='Ext-dd-DragDropManager-method-getRelated'>    /**
 </span>     * Returns the drag and drop instances that are in all groups the
      * passed in instance belongs to.
      * @method getRelated
-     * @param {DragDrop} p_oDD the obj to get related data for
-     * @param {boolean} bTargetsOnly if true, only return targetable objs
-     * @return {DragDrop[]} the related instances
-     * @static
+     * @param {Ext.dd.DragDrop} p_oDD the obj to get related data for
+     * @param {Boolean} bTargetsOnly if true, only return targetable objs
+     * @return {Ext.dd.DragDrop[]} the related instances
      */
     getRelated: function(p_oDD, bTargetsOnly) {
         var oDDs = [];
@@ -407,15 +388,14 @@ Ext.define('Ext.dd.DragDropManager', {
         return oDDs;
     },
 
-<span id='Ext-dd.DragDropManager-method-isLegalTarget'>    /**
+<span id='Ext-dd-DragDropManager-method-isLegalTarget'>    /**
 </span>     * Returns true if the specified dd target is a legal target for
      * the specifice drag obj
      * @method isLegalTarget
-     * @param {DragDrop} oDD the drag obj
-     * @param {DragDrop} oTargetDD the target
-     * @return {boolean} true if the target is a legal target for the
+     * @param {Ext.dd.DragDrop} oDD the drag obj
+     * @param {Ext.dd.DragDrop} oTargetDD the target
+     * @return {Boolean} true if the target is a legal target for the
      * dd obj
-     * @static
      */
     isLegalTarget: function (oDD, oTargetDD) {
         var targets = this.getRelated(oDD, true);
@@ -428,7 +408,7 @@ Ext.define('Ext.dd.DragDropManager', {
         return false;
     },
 
-<span id='Ext-dd.DragDropManager-method-isTypeOfDD'>    /**
+<span id='Ext-dd-DragDropManager-method-isTypeOfDD'>    /**
 </span>     * My goal is to be able to transparently determine if an object is
      * typeof DragDrop, and the exact subclass of DragDrop.  typeof
      * returns &quot;object&quot;, oDD.constructor.toString() always returns
@@ -436,33 +416,30 @@ Ext.define('Ext.dd.DragDropManager', {
      * evaluates a well-known variable in DragDrop.
      * @method isTypeOfDD
      * @param {Object} the object to evaluate
-     * @return {boolean} true if typeof oDD = DragDrop
-     * @static
+     * @return {Boolean} true if typeof oDD = DragDrop
      */
     isTypeOfDD: function (oDD) {
         return (oDD &amp;&amp; oDD.__ygDragDrop);
     },
 
-<span id='Ext-dd.DragDropManager-method-isHandle'>    /**
+<span id='Ext-dd-DragDropManager-method-isHandle'>    /**
 </span>     * Utility function to determine if a given element has been
      * registered as a drag drop handle for the given Drag Drop object.
      * @method isHandle
      * @param {String} id the element id to check
-     * @return {boolean} true if this element is a DragDrop handle, false
+     * @return {Boolean} true if this element is a DragDrop handle, false
      * otherwise
-     * @static
      */
     isHandle: function(sDDId, sHandleId) {
         return ( this.handleIds[sDDId] &amp;&amp;
                         this.handleIds[sDDId][sHandleId] );
     },
 
-<span id='Ext-dd.DragDropManager-method-getDDById'>    /**
+<span id='Ext-dd-DragDropManager-method-getDDById'>    /**
 </span>     * Returns the DragDrop instance for a given id
      * @method getDDById
      * @param {String} id the id of the DragDrop object
-     * @return {DragDrop} the drag drop object, null if it is not found
-     * @static
+     * @return {Ext.dd.DragDrop} the drag drop object, null if it is not found
      */
     getDDById: function(id) {
         for (var i in this.ids) {
@@ -473,14 +450,13 @@ Ext.define('Ext.dd.DragDropManager', {
         return null;
     },
 
-<span id='Ext-dd.DragDropManager-method-handleMouseDown'>    /**
+<span id='Ext-dd-DragDropManager-method-handleMouseDown'>    /**
 </span>     * Fired after a registered DragDrop object gets the mousedown event.
      * Sets up the events required to track the object being dragged
      * @method handleMouseDown
      * @param {Event} e the event
-     * @param oDD the DragDrop object being dragged
+     * @param {Ext.dd.DragDrop} oDD the DragDrop object being dragged
      * @private
-     * @static
      */
     handleMouseDown: function(e, oDD) {
         if(Ext.tip.QuickTipManager){
@@ -491,7 +467,7 @@ Ext.define('Ext.dd.DragDropManager', {
             // so clean up first to avoid breaking the next drag
             this.handleMouseUp(e);
         }
-        
+
         this.currentTarget = e.getTarget();
         this.dragCurrent = oDD;
 
@@ -514,13 +490,12 @@ Ext.define('Ext.dd.DragDropManager', {
                 this.clickTimeThresh );
     },
 
-<span id='Ext-dd.DragDropManager-method-startDrag'>    /**
+<span id='Ext-dd-DragDropManager-method-startDrag'>    /**
 </span>     * Fired when either the drag pixel threshol or the mousedown hold
      * time threshold has been met.
      * @method startDrag
-     * @param x {int} the X position of the original mousedown
-     * @param y {int} the Y position of the original mousedown
-     * @static
+     * @param {Number} x the X position of the original mousedown
+     * @param {Number} y the Y position of the original mousedown
      */
     startDrag: function(x, y) {
         clearTimeout(this.clickTimeout);
@@ -531,17 +506,16 @@ Ext.define('Ext.dd.DragDropManager', {
         this.dragThreshMet = true;
     },
 
-<span id='Ext-dd.DragDropManager-method-handleMouseUp'>    /**
+<span id='Ext-dd-DragDropManager-method-handleMouseUp'>    /**
 </span>     * Internal function to handle the mouseup event.  Will be invoked
      * from the context of the document.
      * @method handleMouseUp
      * @param {Event} e the event
      * @private
-     * @static
      */
     handleMouseUp: function(e) {
 
-        if(Ext.tip.QuickTipManager){
+        if(Ext.tip &amp;&amp; Ext.tip.QuickTipManager){
             Ext.tip.QuickTipManager.ddEnable();
         }
         if (! this.dragCurrent) {
@@ -560,12 +534,11 @@ Ext.define('Ext.dd.DragDropManager', {
         this.stopEvent(e);
     },
 
-<span id='Ext-dd.DragDropManager-method-stopEvent'>    /**
+<span id='Ext-dd-DragDropManager-method-stopEvent'>    /**
 </span>     * Utility to stop event propagation and event default, if these
      * features are turned on.
      * @method stopEvent
      * @param {Event} e the event as returned by this.getEvent()
-     * @static
      */
     stopEvent: function(e){
         if(this.stopPropagation) {
@@ -577,13 +550,12 @@ Ext.define('Ext.dd.DragDropManager', {
         }
     },
 
-<span id='Ext-dd.DragDropManager-method-stopDrag'>    /**
+<span id='Ext-dd-DragDropManager-method-stopDrag'>    /**
 </span>     * Internal function to clean up event handlers after the drag
      * operation is complete
      * @method stopDrag
      * @param {Event} e the event
      * @private
-     * @static
      */
     stopDrag: function(e) {
         // Fire the drag end event for the item that was dragged
@@ -600,7 +572,7 @@ Ext.define('Ext.dd.DragDropManager', {
         this.dragOvers = {};
     },
 
-<span id='Ext-dd.DragDropManager-method-handleMouseMove'>    /**
+<span id='Ext-dd-DragDropManager-method-handleMouseMove'>    /**
 </span>     * Internal function to handle the mousemove event.  Will be invoked
      * from the context of the html element.
      *
@@ -612,7 +584,6 @@ Ext.define('Ext.dd.DragDropManager', {
      * @method handleMouseMove
      * @param {Event} e the event
      * @private
-     * @static
      */
     handleMouseMove: function(e) {
         if (! this.dragCurrent) {
@@ -648,14 +619,13 @@ Ext.define('Ext.dd.DragDropManager', {
         return true;
     },
 
-<span id='Ext-dd.DragDropManager-method-fireEvents'>    /**
+<span id='Ext-dd-DragDropManager-method-fireEvents'>    /**
 </span>     * Iterates over all of the DragDrop elements to find ones we are
      * hovering over or dropping on
      * @method fireEvents
      * @param {Event} e the event
-     * @param {boolean} isDrop is this a drop op or a mouseover op?
+     * @param {Boolean} isDrop is this a drop op or a mouseover op?
      * @private
-     * @static
      */
     fireEvents: function(e, isDrop) {
         var dc = this.dragCurrent;
@@ -784,17 +754,16 @@ Ext.define('Ext.dd.DragDropManager', {
 
     },
 
-<span id='Ext-dd.DragDropManager-method-getBestMatch'>    /**
+<span id='Ext-dd-DragDropManager-method-getBestMatch'>    /**
 </span>     * Helper function for getting the best match from the list of drag
      * and drop objects returned by the drag and drop events when we are
      * in INTERSECT mode.  It returns either the first object that the
      * cursor is over, or the object that has the greatest overlap with
      * the dragged element.
      * @method getBestMatch
-     * @param  {DragDrop[]} dds The array of drag and drop objects
+     * @param  {Ext.dd.DragDrop[]} dds The array of drag and drop objects
      * targeted
-     * @return {DragDrop}       The best single match
-     * @static
+     * @return {Ext.dd.DragDrop}       The best single match
      */
     getBestMatch: function(dds) {
         var winner = null;
@@ -831,7 +800,7 @@ Ext.define('Ext.dd.DragDropManager', {
         return winner;
     },
 
-<span id='Ext-dd.DragDropManager-method-refreshCache'>    /**
+<span id='Ext-dd-DragDropManager-method-refreshCache'>    /**
 </span>     * Refreshes the cache of the top-left and bottom-right points of the
      * drag and drop objects in the specified group(s).  This is in the
      * format that is stored in the drag and drop instance, so typical
@@ -847,7 +816,6 @@ Ext.define('Ext.dd.DragDropManager', {
      * method could accept both.
      * @method refreshCache
      * @param {Object} groups an associative array of groups to refresh
-     * @static
      */
     refreshCache: function(groups) {
         for (var sGroup in groups) {
@@ -873,15 +841,14 @@ Ext.define('Ext.dd.DragDropManager', {
         }
     },
 
-<span id='Ext-dd.DragDropManager-method-verifyEl'>    /**
+<span id='Ext-dd-DragDropManager-method-verifyEl'>    /**
 </span>     * This checks to make sure an element exists and is in the DOM.  The
      * main purpose is to handle cases where innerHTML is used to remove
      * drag and drop objects from the DOM.  IE provides an 'unspecified
      * error' when trying to access the offsetParent of such an element
      * @method verifyEl
      * @param {HTMLElement} el the element to check
-     * @return {boolean} true if the element looks usable
-     * @static
+     * @return {Boolean} true if the element looks usable
      */
     verifyEl: function(el) {
         if (el) {
@@ -901,16 +868,14 @@ Ext.define('Ext.dd.DragDropManager', {
         return false;
     },
 
-<span id='Ext-dd.DragDropManager-method-getLocation'>    /**
+<span id='Ext-dd-DragDropManager-method-getLocation'>    /**
 </span>     * Returns a Region object containing the drag and drop element's position
      * and size, including the padding configured for it
      * @method getLocation
-     * @param {DragDrop} oDD the drag and drop object to get the
-     *                       location for
+     * @param {Ext.dd.DragDrop} oDD the drag and drop object to get the location for.
      * @return {Ext.util.Region} a Region object representing the total area
-     *                             the element occupies, including any padding
-     *                             the instance is configured for.
-     * @static
+     * the element occupies, including any padding
+     * the instance is configured for.
      */
     getLocation: function(oDD) {
         if (! this.isTypeOfDD(oDD)) {
@@ -926,7 +891,7 @@ Ext.define('Ext.dd.DragDropManager', {
         var el = oDD.getEl(), pos, x1, x2, y1, y2, t, r, b, l;
 
         try {
-            pos= Ext.core.Element.getXY(el);
+            pos= Ext.Element.getXY(el);
         } catch (e) { }
 
         if (!pos) {
@@ -946,14 +911,13 @@ Ext.define('Ext.dd.DragDropManager', {
         return Ext.create('Ext.util.Region', t, r, b, l);
     },
 
-<span id='Ext-dd.DragDropManager-method-isOverTarget'>    /**
+<span id='Ext-dd-DragDropManager-method-isOverTarget'>    /**
 </span>     * Checks the cursor location to see if it over the target
      * @method isOverTarget
      * @param {Ext.util.Point} pt The point to evaluate
-     * @param {DragDrop} oTarget the DragDrop object we are inspecting
-     * @return {boolean} true if the mouse is over the target
+     * @param {Ext.dd.DragDrop} oTarget the DragDrop object we are inspecting
+     * @return {Boolean} true if the mouse is over the target
      * @private
-     * @static
      */
     isOverTarget: function(pt, oTarget, intersect) {
         // use cache if available
@@ -1005,21 +969,19 @@ Ext.define('Ext.dd.DragDropManager', {
         }
     },
 
-<span id='Ext-dd.DragDropManager-method-_onUnload'>    /**
+<span id='Ext-dd-DragDropManager-method-_onUnload'>    /**
 </span>     * unload event handler
      * @method _onUnload
      * @private
-     * @static
      */
     _onUnload: function(e, me) {
         Ext.dd.DragDropManager.unregAll();
     },
 
-<span id='Ext-dd.DragDropManager-method-unregAll'>    /**
+<span id='Ext-dd-DragDropManager-method-unregAll'>    /**
 </span>     * Cleans up the drag and drop events and objects.
      * @method unregAll
      * @private
-     * @static
      */
     unregAll: function() {
 
@@ -1038,22 +1000,20 @@ Ext.define('Ext.dd.DragDropManager', {
         this.ids = {};
     },
 
-<span id='Ext-dd.DragDropManager-property-elementCache'>    /**
+<span id='Ext-dd-DragDropManager-property-elementCache'>    /**
 </span>     * A cache of DOM elements
      * @property elementCache
      * @private
-     * @static
      */
     elementCache: {},
 
-<span id='Ext-dd.DragDropManager-method-getElWrapper'>    /**
+<span id='Ext-dd-DragDropManager-method-getElWrapper'>    /**
 </span>     * Get the wrapper for the DOM element specified
      * @method getElWrapper
      * @param {String} id the id of the element to get
-     * @return {Ext.dd.DDM.ElementWrapper} the wrapped element
+     * @return {Ext.dd.DragDropManager.ElementWrapper} the wrapped element
      * @private
      * @deprecated This wrapper isn't that useful
-     * @static
      */
     getElWrapper: function(id) {
         var oWrapper = this.elementCache[id];
@@ -1064,86 +1024,79 @@ Ext.define('Ext.dd.DragDropManager', {
         return oWrapper;
     },
 
-<span id='Ext-dd.DragDropManager-method-getElement'>    /**
+<span id='Ext-dd-DragDropManager-method-getElement'>    /**
 </span>     * Returns the actual DOM element
      * @method getElement
      * @param {String} id the id of the elment to get
      * @return {Object} The element
      * @deprecated use Ext.lib.Ext.getDom instead
-     * @static
      */
     getElement: function(id) {
         return Ext.getDom(id);
     },
 
-<span id='Ext-dd.DragDropManager-method-getCss'>    /**
+<span id='Ext-dd-DragDropManager-method-getCss'>    /**
 </span>     * Returns the style property for the DOM element (i.e.,
      * document.getElById(id).style)
      * @method getCss
      * @param {String} id the id of the elment to get
      * @return {Object} The style property of the element
-     * @static
      */
     getCss: function(id) {
         var el = Ext.getDom(id);
         return (el) ? el.style : null;
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper'>    /**
-</span>     * Inner class for cached elements
-     * @class Ext.dd.DragDropManager.ElementWrapper
-     * @for DragDropManager
+<span id='Ext-dd-DragDropManager-ElementWrapper'>    /**
+</span>     * @class Ext.dd.DragDropManager.ElementWrapper
+     * Inner class for cached elements
      * @private
      * @deprecated
      */
     ElementWrapper: function(el) {
-<span id='Ext-dd.DragDropManager.ElementWrapper-property-el'>            /**
-</span>             * The element
-             * @property el
-             */
-            this.el = el || null;
-<span id='Ext-dd.DragDropManager.ElementWrapper-property-id'>            /**
-</span>             * The element id
-             * @property id
-             */
-            this.id = this.el &amp;&amp; el.id;
-<span id='Ext-dd.DragDropManager.ElementWrapper-property-css'>            /**
-</span>             * A reference to the style property
-             * @property css
-             */
-            this.css = this.el &amp;&amp; el.style;
-        },
-
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-getPosX'>    /**
+<span id='Ext-dd-DragDropManager-ElementWrapper-property-el'>        /**
+</span>         * The element
+         * @property el
+         */
+        this.el = el || null;
+<span id='Ext-dd-DragDropManager-ElementWrapper-property-id'>        /**
+</span>         * The element id
+         * @property id
+         */
+        this.id = this.el &amp;&amp; el.id;
+<span id='Ext-dd-DragDropManager-ElementWrapper-property-css'>        /**
+</span>         * A reference to the style property
+         * @property css
+         */
+        this.css = this.el &amp;&amp; el.style;
+    },
+
+    // The DragDropManager class continues
+<span id='Ext-dd-DragDropManager'>    /** @class Ext.dd.DragDropManager */
+</span>
+<span id='Ext-dd-DragDropManager-method-getPosX'>    /**
 </span>     * Returns the X position of an html element
-     * @method getPosX
-     * @param el the element for which to get the position
-     * @return {int} the X coordinate
-     * @for DragDropManager
-     * @static
+     * @param {HTMLElement} el the element for which to get the position
+     * @return {Number} the X coordinate
      */
     getPosX: function(el) {
-        return Ext.core.Element.getX(el);
+        return Ext.Element.getX(el);
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-getPosY'>    /**
+<span id='Ext-dd-DragDropManager-method-getPosY'>    /**
 </span>     * Returns the Y position of an html element
-     * @method getPosY
-     * @param el the element for which to get the position
-     * @return {int} the Y coordinate
-     * @static
+     * @param {HTMLElement} el the element for which to get the position
+     * @return {Number} the Y coordinate
      */
     getPosY: function(el) {
-        return Ext.core.Element.getY(el);
+        return Ext.Element.getY(el);
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-swapNode'>    /**
+<span id='Ext-dd-DragDropManager-method-swapNode'>    /**
 </span>     * Swap two nodes.  In IE, we use the native method, for others we
      * emulate the IE behavior
-     * @method swapNode
-     * @param n1 the first node to swap
-     * @param n2 the other node to swap
-     * @static
+     * @param {HTMLElement} n1 the first node to swap
+     * @param {HTMLElement} n2 the other node to swap
      */
     swapNode: function(n1, n2) {
         if (n1.swapNode) {
@@ -1163,11 +1116,9 @@ Ext.define('Ext.dd.DragDropManager', {
         }
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-getScroll'>    /**
+<span id='Ext-dd-DragDropManager-method-getScroll'>    /**
 </span>     * Returns the current scroll position
-     * @method getScroll
      * @private
-     * @static
      */
     getScroll: function () {
         var doc   = window.document,
@@ -1175,7 +1126,7 @@ Ext.define('Ext.dd.DragDropManager', {
             body  = doc.body,
             top   = 0,
             left  = 0;
-            
+
         if (Ext.isGecko4) {
             top  = window.scrollYOffset;
             left = window.scrollXOffset;
@@ -1186,7 +1137,7 @@ Ext.define('Ext.dd.DragDropManager', {
             } else if (body) {
                 top  = body.scrollTop;
                 left = body.scrollLeft;
-            } 
+            }
         }
         return {
             top: top,
@@ -1194,74 +1145,64 @@ Ext.define('Ext.dd.DragDropManager', {
         };
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-getStyle'>    /**
+<span id='Ext-dd-DragDropManager-method-getStyle'>    /**
 </span>     * Returns the specified element style property
-     * @method getStyle
      * @param {HTMLElement} el          the element
-     * @param {string}      styleProp   the style property
-     * @return {string} The value of the style property
-     * @static
+     * @param {String}      styleProp   the style property
+     * @return {String} The value of the style property
      */
     getStyle: function(el, styleProp) {
         return Ext.fly(el).getStyle(styleProp);
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-getScrollTop'>    /**
+<span id='Ext-dd-DragDropManager-method-getScrollTop'>    /**
 </span>     * Gets the scrollTop
-     * @method getScrollTop
-     * @return {int} the document's scrollTop
-     * @static
+     * @return {Number} the document's scrollTop
      */
     getScrollTop: function () {
         return this.getScroll().top;
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-getScrollLeft'>    /**
+<span id='Ext-dd-DragDropManager-method-getScrollLeft'>    /**
 </span>     * Gets the scrollLeft
-     * @method getScrollLeft
-     * @return {int} the document's scrollTop
-     * @static
+     * @return {Number} the document's scrollTop
      */
     getScrollLeft: function () {
         return this.getScroll().left;
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-moveToEl'>    /**
+<span id='Ext-dd-DragDropManager-method-moveToEl'>    /**
 </span>     * Sets the x/y position of an element to the location of the
      * target element.
-     * @method moveToEl
      * @param {HTMLElement} moveEl      The element to move
      * @param {HTMLElement} targetEl    The position reference element
-     * @static
      */
     moveToEl: function (moveEl, targetEl) {
-        var aCoord = Ext.core.Element.getXY(targetEl);
-        Ext.core.Element.setXY(moveEl, aCoord);
+        var aCoord = Ext.Element.getXY(targetEl);
+        Ext.Element.setXY(moveEl, aCoord);
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-numericSort'>    /**
+<span id='Ext-dd-DragDropManager-method-numericSort'>    /**
 </span>     * Numeric array sort function
-     * @method numericSort
-     * @static
+     * @param {Number} a
+     * @param {Number} b
+     * @returns {Number} positive, negative or 0
      */
     numericSort: function(a, b) {
         return (a - b);
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-property-_timeoutCount'>    /**
+<span id='Ext-dd-DragDropManager-property-_timeoutCount'>    /**
 </span>     * Internal counter
-     * @property _timeoutCount
+     * @property {Number} _timeoutCount
      * @private
-     * @static
      */
     _timeoutCount: 0,
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-_addListeners'>    /**
+<span id='Ext-dd-DragDropManager-method-_addListeners'>    /**
 </span>     * Trying to make the load order less important.  Without this we get
      * an error if this file is loaded before the Event Utility.
-     * @method _addListeners
      * @private
-     * @static
      */
     _addListeners: function() {
         if ( document ) {
@@ -1277,13 +1218,11 @@ Ext.define('Ext.dd.DragDropManager', {
         }
     },
 
-<span id='Ext-dd.DragDropManager.ElementWrapper-method-handleWasClicked'>    /**
+<span id='Ext-dd-DragDropManager-method-handleWasClicked'>    /**
 </span>     * Recursively searches the immediate parent and all child nodes for
      * the handle element in order to determine wheter or not it was
      * clicked.
-     * @method handleWasClicked
-     * @param node the html element to inspect
-     * @static
+     * @param {HTMLElement} node the html element to inspect
      */
     handleWasClicked: function(node, id) {
         if (this.isHandle(id, node.id)) {
@@ -1306,4 +1245,6 @@ Ext.define('Ext.dd.DragDropManager', {
 }, function() {
     this._addListeners();
 });
-</pre></pre></body></html>
\ No newline at end of file
+</pre>
+</body>
+</html>