X-Git-Url: http://git.ithinksw.org/extjs.git/blobdiff_plain/7a654f8d43fdb43d78b63d90528bed6e86b608cc..3789b528d8dd8aad4558e38e22d775bcab1cbd36:/docs/source/Floating.html diff --git a/docs/source/Floating.html b/docs/source/Floating.html index c12644db..7bbf402b 100644 --- a/docs/source/Floating.html +++ b/docs/source/Floating.html @@ -1,4 +1,21 @@ -Sencha Documentation Project
/**
+
+
+
+  
+  The source code
+  
+  
+  
+  
+
+
+  
/**
  * @class Ext.util.Floating
  * A mixin to add floating capability to a Component
  */
@@ -6,14 +23,14 @@ Ext.define('Ext.util.Floating', {
 
     uses: ['Ext.Layer', 'Ext.window.Window'],
 
-    /**
+    /**
      * @cfg {Boolean} focusOnToFront
      * Specifies whether the floated component should be automatically {@link #focus focused} when it is
      * {@link #toFront brought to the front}. Defaults to true.
      */
     focusOnToFront: true,
 
-    /**
+    /**
      * @cfg {String/Boolean} shadow Specifies whether the floating component should be given a shadow. Set to
      * <tt>true</tt> to automatically create an {@link Ext.Shadow}, or a string indicating the
      * shadow's display {@link Ext.Shadow#mode}. Set to <tt>false</tt> to disable the shadow.
@@ -88,7 +105,7 @@ Ext.define('Ext.util.Floating', {
         }
     },
 
-    /**
+    /**
      * @private
      * <p>Finds the ancestor Container responsible for allocating zIndexes for the passed Component.</p>
      * <p>That will be the outermost floating Container (a Container which has no ownerCt and has floating:true).</p>
@@ -130,7 +147,7 @@ Ext.define('Ext.util.Floating', {
         return index;
     },
 
-    /**
+    /**
      * <p>Moves this floating Component into a constrain region.</p>
      * <p>By default, this Component is constrained to be within the container it was added to, or the element
      * it was rendered to.</p>
@@ -139,27 +156,36 @@ Ext.define('Ext.util.Floating', {
      */
     doConstrain: function(constrainTo) {
         var me = this,
-            constrainEl,
-            vector,
+            vector = me.getConstrainVector(constrainTo),
             xy;
 
+        if (vector) {
+            xy = me.getPosition();
+            xy[0] += vector[0];
+            xy[1] += vector[1];
+            me.setPosition(xy);
+        }
+    },
+    
+    
+    /**
+     * Gets the x/y offsets to constrain this float
+     * @private
+     * @param {Mixed} constrainTo Optional. The Element or {@link Ext.util.Region Region} into which this Component is to be constrained.
+     * @return {Array} The x/y constraints
+     */
+    getConstrainVector: function(constrainTo){
+        var me = this,
+            el;
+            
         if (me.constrain || me.constrainHeader) {
-            if (me.constrainHeader) {
-                constrainEl = me.header.el;
-            } else {
-                constrainEl = me.el;
-            }
-            vector = constrainEl.getConstrainVector(constrainTo || (me.floatParent && me.floatParent.getTargetEl()) || me.container);
-            if (vector) {
-                xy = me.getPosition();
-                xy[0] += vector[0];
-                xy[1] += vector[1];
-                me.setPosition(xy);
-            }
+            el = me.constrainHeader ? me.header.el : me.el;
+            constrainTo = constrainTo || (me.floatParent && me.floatParent.getTargetEl()) || me.container;
+            return el.getConstrainVector(constrainTo);
         }
     },
 
-    /**
+    /**
      * Aligns this floating Component to the specified element
      * @param {Mixed} element The element or {@link Ext.Component} to align to. If passing a component, it must
      * be a omponent instance. If a string id is passed, it will be used as an element id.
@@ -176,7 +202,7 @@ Ext.define('Ext.util.Floating', {
         return this;
     },
 
-    /**
+    /**
      * <p>Brings this floating Component to the front of any other visible, floating Components managed by the same {@link Ext.ZIndexManager ZIndexManager}</p>
      * <p>If this Component is modal, inserts the modal mask just below this Component in the z-index stack.</p>
      * @param {Boolean} preventFocus (optional) Specify <code>true</code> to prevent the Component from being focused.
@@ -204,7 +230,7 @@ Ext.define('Ext.util.Floating', {
         return me;
     },
 
-    /**
+    /**
      * <p>This method is called internally by {@link Ext.ZIndexManager} to signal that a floating
      * Component has either been moved to the top of its zIndex stack, or pushed from the top of its zIndex stack.</p>
      * <p>If a <i>Window</i> is superceded by another Window, deactivating it hides its shadow.</p>
@@ -228,7 +254,7 @@ Ext.define('Ext.util.Floating', {
         }
     },
 
-    /**
+    /**
      * Sends this Component to the back of (lower z-index than) any other visible windows
      * @return {Component} this
      */
@@ -237,7 +263,7 @@ Ext.define('Ext.util.Floating', {
         return this;
     },
 
-    /**
+    /**
      * Center this Component in its container.
      * @return {Component} this
      */
@@ -262,4 +288,6 @@ Ext.define('Ext.util.Floating', {
 
         this.setSize(size);
     }
-});
\ No newline at end of file +});
+ +