-<!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><span id='Ext-util.Region'>/**
-</span> * @class Ext.util.Region
- * @extends Object
+<!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"><span id='Ext-util-Region'>/**
+</span> * This class represents a rectangular region in X,Y space, and performs geometric
+ * transformations or tests upon the region.
*
- * Represents a rectangular region and provides a number of utility methods
- * to compare regions.
+ * This class may be used to compare the document regions occupied by elements.
*/
-
Ext.define('Ext.util.Region', {
/* Begin Definitions */
requires: ['Ext.util.Offset'],
statics: {
-<span id='Ext-util.Region-method-getRegion'> /**
+<span id='Ext-util-Region-static-method-getRegion'> /**
</span> * @static
- * @param {Mixed} el A string, DomElement or Ext.core.Element representing an element
- * on the page.
- * @returns {Ext.util.Region} region
* Retrieves an Ext.util.Region for a particular element.
+ * @param {String/HTMLElement/Ext.Element} el An element ID, htmlElement or Ext.Element representing an element in the document.
+ * @returns {Ext.util.Region} region
*/
getRegion: function(el) {
return Ext.fly(el).getPageBox(true);
},
-<span id='Ext-util.Region-method-from'> /**
+<span id='Ext-util-Region-static-method-from'> /**
</span> * @static
- * @param {Object} o An object with top, right, bottom, left properties
- * @return {Ext.util.Region} region The region constructed based on the passed object
+ * Creates a Region from a "box" Object which contains four numeric properties `top`, `right`, `bottom` and `left`.
+ * @param {Object} o An object with `top`, `right`, `bottom` and `left` properties.
+ * @return {Ext.util.Region} region The Region constructed based on the passed object
*/
from: function(o) {
return new this(o.top, o.right, o.bottom, o.left);
/* End Definitions */
-<span id='Ext-util.Region-method-constructor'> /**
-</span> * @constructor
- * @param {Number} top Top
- * @param {Number} right Right
- * @param {Number} bottom Bottom
- * @param {Number} left Left
+<span id='Ext-util-Region-method-constructor'> /**
+</span> * Creates a region from the bounding sides.
+ * @param {Number} top Top The topmost pixel of the Region.
+ * @param {Number} right Right The rightmost pixel of the Region.
+ * @param {Number} bottom Bottom The bottom pixel of the Region.
+ * @param {Number} left Left The leftmost pixel of the Region.
*/
constructor : function(t, r, b, l) {
var me = this;
me.x = me.left = me[0] = l;
},
-<span id='Ext-util.Region-method-contains'> /**
+<span id='Ext-util-Region-method-contains'> /**
</span> * Checks if this region completely contains the region that is passed in.
* @param {Ext.util.Region} region
+ * @return {Boolean}
*/
contains : function(region) {
var me = this;
},
-<span id='Ext-util.Region-method-intersect'> /**
+<span id='Ext-util-Region-method-intersect'> /**
</span> * Checks if this region intersects the region passed in.
* @param {Ext.util.Region} region
* @return {Ext.util.Region/Boolean} Returns the intersected region or false if there is no intersection.
}
},
-<span id='Ext-util.Region-method-union'> /**
+<span id='Ext-util-Region-method-union'> /**
</span> * Returns the smallest region that contains the current AND targetRegion.
* @param {Ext.util.Region} region
+ * @return {Ext.util.Region} a new region
*/
union : function(region) {
var me = this,
return new this.self(t, r, b, l);
},
-<span id='Ext-util.Region-method-constrainTo'> /**
+<span id='Ext-util-Region-method-constrainTo'> /**
</span> * Modifies the current region to be constrained to the targetRegion.
* @param {Ext.util.Region} targetRegion
+ * @return {Ext.util.Region} this
*/
constrainTo : function(r) {
var me = this,
return me;
},
-<span id='Ext-util.Region-method-adjust'> /**
+<span id='Ext-util-Region-method-adjust'> /**
</span> * Modifies the current region to be adjusted by offsets.
* @param {Number} top top offset
* @param {Number} right right offset
* @param {Number} bottom bottom offset
* @param {Number} left left offset
+ * @return {Ext.util.Region} this
*/
adjust : function(t, r, b, l) {
var me = this;
return me;
},
-<span id='Ext-util.Region-method-getOutOfBoundOffset'> /**
+<span id='Ext-util-Region-method-getOutOfBoundOffset'> /**
</span> * Get the offset amount of a point outside the region
- * @param {String} axis optional
- * @param {Ext.util.Point} p the point
+ * @param {String} [axis]
+ * @param {Ext.util.Point} [p] the point
* @return {Ext.util.Offset}
*/
getOutOfBoundOffset: function(axis, p) {
},
-<span id='Ext-util.Region-method-getOutOfBoundOffsetX'> /**
+<span id='Ext-util-Region-method-getOutOfBoundOffsetX'> /**
</span> * Get the offset amount on the x-axis
* @param {Number} p the offset
* @return {Number}
return 0;
},
-<span id='Ext-util.Region-method-getOutOfBoundOffsetY'> /**
+<span id='Ext-util-Region-method-getOutOfBoundOffsetY'> /**
</span> * Get the offset amount on the y-axis
* @param {Number} p the offset
* @return {Number}
return 0;
},
-<span id='Ext-util.Region-method-isOutOfBound'> /**
+<span id='Ext-util-Region-method-isOutOfBound'> /**
</span> * Check whether the point / offset is out of bound
- * @param {String} axis optional
- * @param {Ext.util.Point/Number} p the point / offset
+ * @param {String} [axis]
+ * @param {Ext.util.Point/Number} [p] the point / offset
* @return {Boolean}
*/
isOutOfBound: function(axis, p) {
}
},
-<span id='Ext-util.Region-method-isOutOfBoundX'> /**
+<span id='Ext-util-Region-method-isOutOfBoundX'> /**
</span> * Check whether the offset is out of bound in the x-axis
* @param {Number} p the offset
* @return {Boolean}
return (p < this.x || p > this.right);
},
-<span id='Ext-util.Region-method-isOutOfBoundY'> /**
+<span id='Ext-util-Region-method-isOutOfBoundY'> /**
</span> * Check whether the offset is out of bound in the y-axis
* @param {Number} p the offset
* @return {Boolean}
return (p < this.y || p > this.bottom);
},
- /*
- * Restrict a point within the region by a certain factor.
- * @param {String} axis Optional
- * @param {Ext.util.Point/Ext.util.Offset/Object} p
- * @param {Number} factor
+<span id='Ext-util-Region-method-restrict'> /**
+</span> * Restrict a point within the region by a certain factor.
+ * @param {String} [axis]
+ * @param {Ext.util.Point/Ext.util.Offset/Object} [p]
+ * @param {Number} [factor]
* @return {Ext.util.Point/Ext.util.Offset/Object/Number}
+ * @private
*/
restrict: function(axis, p, factor) {
if (Ext.isObject(axis)) {
}
},
- /*
- * Restrict an offset within the region by a certain factor, on the x-axis
+<span id='Ext-util-Region-method-restrictX'> /**
+</span> * Restrict an offset within the region by a certain factor, on the x-axis
* @param {Number} p
- * @param {Number} factor The factor, optional, defaults to 1
- * @return
+ * @param {Number} [factor=1] The factor.
+ * @return {Number}
+ * @private
*/
restrictX : function(p, factor) {
if (!factor) {
return p;
},
- /*
- * Restrict an offset within the region by a certain factor, on the y-axis
+<span id='Ext-util-Region-method-restrictY'> /**
+</span> * Restrict an offset within the region by a certain factor, on the y-axis
* @param {Number} p
- * @param {Number} factor The factor, optional, defaults to 1
+ * @param {Number} [factor] The factor, defaults to 1
+ * @return {Number}
+ * @private
*/
restrictY : function(p, factor) {
if (!factor) {
return p;
},
- /*
- * Get the width / height of this region
+<span id='Ext-util-Region-method-getSize'> /**
+</span> * Get the width / height of this region
* @return {Object} an object with width and height properties
+ * @private
*/
getSize: function() {
return {
};
},
-<span id='Ext-util.Region-method-copy'> /**
-</span> * Copy a new instance
+<span id='Ext-util-Region-method-copy'> /**
+</span> * Create a copy of this Region.
* @return {Ext.util.Region}
*/
copy: function() {
return new this.self(this.y, this.right, this.bottom, this.x);
},
-<span id='Ext-util.Region-method-copyFrom'> /**
+<span id='Ext-util-Region-method-copyFrom'> /**
</span> * Copy the values of another Region to this Region
- * @param {Region} The region to copy from.
- * @return {Ext.util.Point} this This point
+ * @param {Ext.util.Region} p The region to copy from.
+ * @return {Ext.util.Region} This Region
*/
copyFrom: function(p) {
var me = this;
return this;
},
-<span id='Ext-util.Region-method-toString'> /**
-</span> * Dump this to an eye-friendly string, great for debugging
+ /*
+ * Dump this to an eye-friendly string, great for debugging
* @return {String}
*/
toString: function() {
return "Region[" + this.top + "," + this.right + "," + this.bottom + "," + this.left + "]";
},
-
-<span id='Ext-util.Region-method-translateBy'> /**
+<span id='Ext-util-Region-method-translateBy'> /**
</span> * Translate this region by the given offset amount
- * @param {Ext.util.Offset/Object} offset Object containing the <code>x</code> and <code>y</code> properties.
+ * @param {Ext.util.Offset/Object} x Object containing the `x` and `y` properties.
* Or the x value is using the two argument form.
- * @param {Number} The y value unless using an Offset object.
+ * @param {Number} y The y value unless using an Offset object.
* @return {Ext.util.Region} this This Region
*/
translateBy: function(x, y) {
return me;
},
-<span id='Ext-util.Region-method-round'> /**
+<span id='Ext-util-Region-method-round'> /**
</span> * Round all the properties of this region
* @return {Ext.util.Region} this This Region
*/
return me;
},
-<span id='Ext-util.Region-method-equals'> /**
+<span id='Ext-util-Region-method-equals'> /**
</span> * Check whether this region is equivalent to the given region
* @param {Ext.util.Region} region The region to compare with
* @return {Boolean}
return (this.top == region.top && this.right == region.right && this.bottom == region.bottom && this.left == region.left);
}
});
-</pre></pre></body></html>
\ No newline at end of file
+</pre>
+</body>
+</html>
git.ithinksw.org / extjs.git / blobdiff