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 @@ -
/**
+
+
+
+
+ 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
+});
+
+