For up to date documentation and features, visit http://docs.sencha.com/ext-js/4-0

Sencha Documentation

Represents a rectangular region and provides a number of utility methods to compare regions.

Defined By

Methods

 
Region( Number top, Number right, Number bottom, Number left) : void

 

Parameters

  • top : Number

    Top

  • right : Number

    Right

  • bottom : Number

    Bottom

  • left : Number

    Left

Returns

  • void   
 
adjust( Number top, Number right, Number bottom, Number left) : void

Modifies the current region to be adjusted by offsets.

Modifies the current region to be adjusted by offsets.

Parameters

  • top : Number

    top offset

  • right : Number

    right offset

  • bottom : Number

    bottom offset

  • left : Number

    left offset

Returns

  • void   
 
constrainTo( Ext.util.Region targetRegion) : void

Modifies the current region to be constrained to the targetRegion.

Modifies the current region to be constrained to the targetRegion.

Parameters

  • targetRegion : Ext.util.Region

Returns

  • void   
 
contains( Ext.util.Region region) : void

Checks if this region completely contains the region that is passed in.

Checks if this region completely contains the region that is passed in.

Parameters

  • region : Ext.util.Region

Returns

  • void   
 

Copy a new instance

Copy a new instance

Returns

  • Ext.util.Region   
 
copyFrom( Region The) : Ext.util.Point

Copy the values of another Region to this Region

Copy the values of another Region to this Region

Parameters

  • The : Region

    region to copy from.

Returns

  • Ext.util.Point   

    this This point

 
equals( Ext.util.Region region) : Boolean

Check whether this region is equivalent to the given region

Check whether this region is equivalent to the given region

Parameters

  • region : Ext.util.Region

    The region to compare with

Returns

  • Boolean   
 
from( Object o) : Ext.util.Region

 

Parameters

  • o : Object

    An object with top, right, bottom, left properties

Returns

  • Ext.util.Region   

    region The region constructed based on the passed object

 
getOutOfBoundOffset( String axis, Ext.util.Point p) : Ext.util.Offset

Get the offset amount of a point outside the region

Get the offset amount of a point outside the region

Parameters

  • axis : String

    optional

  • p : Ext.util.Point

    the point

Returns

  • Ext.util.Offset   
 

Get the offset amount on the x-axis

Get the offset amount on the x-axis

Parameters

  • p : Number

    the offset

Returns

  • Number   
 

Get the offset amount on the y-axis

Get the offset amount on the y-axis

Parameters

  • p : Number

    the offset

Returns

  • Number   
 
getRegion( Mixed el) : Ext.util.Region

 

Parameters

  • el : Mixed

    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.

 
intersect( Ext.util.Region region) : Ext.util.Region/Boolean

Checks if this region intersects the region passed in.

Checks if this region intersects the region passed in.

Parameters

  • region : Ext.util.Region

Returns

  • Ext.util.Region/Boolean   

    Returns the intersected region or false if there is no intersection.

 
isOutOfBound( String axis, Ext.util.Point/Number p) : Boolean

Check whether the point / offset is out of bound

Check whether the point / offset is out of bound

Parameters

  • axis : String

    optional

  • p : Ext.util.Point/Number

    the point / offset

Returns

  • Boolean   
 

Check whether the offset is out of bound in the x-axis

Check whether the offset is out of bound in the x-axis

Parameters

  • p : Number

    the offset

Returns

  • Boolean   
 

Check whether the offset is out of bound in the y-axis

Check whether the offset is out of bound in the y-axis

Parameters

  • p : Number

    the offset

Returns

  • Boolean   
 

Round all the properties of this region

Round all the properties of this region

Returns

  • Ext.util.Region   

    this This Region

 

Dump this to an eye-friendly string, great for debugging

Dump this to an eye-friendly string, great for debugging

Returns

  • String   
 
translateBy( Ext.util.Offset/Object offset, Number The) : Ext.util.Region

Translate this region by the given offset amount

Translate this region by the given offset amount

Parameters

  • offset : Ext.util.Offset/Object

    Object containing the x and y properties. Or the x value is using the two argument form.

  • The : Number

    y value unless using an Offset object.

Returns

  • Ext.util.Region   

    this This Region

 
union( Ext.util.Region region) : void

Returns the smallest region that contains the current AND targetRegion.

Returns the smallest region that contains the current AND targetRegion.

Parameters

  • region : Ext.util.Region

Returns

  • void