| Paquete | flash.geom |
| Clase | public class Rectangle |
| Herencia | Rectangle  Object |
| Subclases | RoundedRectangle |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Como las propiedadesx, y, width y height de la clase Rectangle son independientes entre sí, el cambio del valor de una propiedad no afecta a las otras. Sin embargo, las propiedades right y bottom están relacionadas de forma integral con dichas cuatro propiedades. Por ejemplo, si cambia el valor de la propiedad right, el valor de la propiedad width cambiará; si cambia la propiedad bottom, el valor de la propiedad height cambiará.
Los siguientes métodos y propiedades utilizan objetos Rectangle:
- Los métodos
applyFilter(),colorTransform(),copyChannel(),copyPixels(),draw(),fillRect(),generateFilterRect(),getColorBoundsRect(),getPixels(),merge(),paletteMap(),pixelDisolve(),setPixels()ythreshold(), y la propiedadrectde la clase BitmapData. - Los métodos
getBounds()ygetRect(), y las propiedadesscrollRectyscale9Gridde la clase DisplayObject. - El método
getCharBoundaries()de la clase TextField. - La propiedad
pixelBoundsde la clase Transform. - El parámetro
boundspara el métodostartDrag()de la clase Sprite. - El parámetro
printAreadel métodoaddPage()de la clase PrintJob.
Puede utilizar el constructor new Rectangle() para crear un objeto Rectangle.
Nota: la clase Rectangle no define un objeto de visualización Shape rectangular. Para dibujar un objeto Shape rectangular en la pantalla, utilice el método drawRect() de la clase Graphics.
Elementos de API relacionados
flash.display.BitmapData
flash.display.DisplayObject
flash.display.NativeWindow
flash.text.TextField.getCharBoundaries()
flash.geom.Transform.pixelBounds
flash.display.Sprite.startDrag()
flash.printing.PrintJob.addPage()
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| bottom : Number
Suma de las propiedades height e y. | Rectangle | ||
| bottomRight : Point
La posición del ángulo inferior derecho del objeto Rectangle viene determinada por los valores right y bottom. | Rectangle | ||
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| height : Number
La altura del rectángulo, en píxeles. | Rectangle | ||
| left : Number
La coordenada x del ángulo superior izquierdo del rectángulo. | Rectangle | ||
| right : Number
Suma de las propiedades width y x. | Rectangle | ||
| size : Point
El tamaño del objeto Rectangle, expresado como un objeto Point con valores width y height. | Rectangle | ||
| top : Number
La coordenada y del ángulo superior izquierdo del rectángulo. | Rectangle | ||
| topLeft : Point
La posición del ángulo superior izquierdo del objeto Rectangle viene determinada por las coordenadas x e y del punto. | Rectangle | ||
| width : Number
La anchura del rectángulo, en píxeles. | Rectangle | ||
| x : Number
La coordenada x del ángulo superior izquierdo del rectángulo. | Rectangle | ||
| y : Number
La coordenada y del ángulo superior izquierdo del rectángulo. | Rectangle | ||
| Método | Definido por | ||
|---|---|---|---|
Crea un nuevo objeto Rectangle con la esquina superior izquierda especificada por los parámetros x e y con los parámetros width y height especificados. | Rectangle | ||
Devuelve un objeto Rectangle nuevo con las mismas propiedades x, y, width y height que el objeto Rectangle original. | Rectangle | ||
Determina si el punto especificado está incluido en la región rectangular definida por este objeto Rectangle. | Rectangle | ||
Determina si el punto especificado está incluido en la región rectangular definida por este objeto Rectangle. | Rectangle | ||
Determina si el objeto Rectangle especificado por el parámetro rect se encuentra dentro de este objeto Rectangle. | Rectangle | ||
Copia todos los datos del rectángulo desde el objeto Rectangle de origen en el objeto Rectangle de llamada. | Rectangle | ||
Determina si el objeto especificado en el parámetro toCompare es igual a este objeto Rectangle. | Rectangle | ||
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
Expande el objeto Rectangle según las cantidades especificadas en píxeles. | Rectangle | ||
Aumenta el tamaño del objeto Rectangle. | Rectangle | ||
Si el objeto Rectangle especificado en el parámetro toIntersect presenta un punto de intersección con este objeto Rectangle, devuelve el área de intersección como un objeto Rectangle. | Rectangle | ||
Determina si el objeto especificado en el parámetro toIntersect presenta un punto de intersección con este objeto Rectangle. | Rectangle | ||
Determina si este objeto Rectangle está vacío o no. | Rectangle | ||
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
Ajusta la posición del objeto Rectangle, definida por su ángulo superior izquierdo, según las cantidades especificadas. | Rectangle | ||
Ajusta la ubicación del objeto Rectangle utilizando un objeto Point como parámetro. | Rectangle | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
Establece todas las propiedades del objeto Rectangle en 0. | Rectangle | ||
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
Define los miembros del rectángulo en los valores especificados
| Rectangle | ||
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
Crea y devuelve una cadena en la que se indican las posiciones horizontal y vertical, así como la anchura y la altura, del objeto Rectangle. | Rectangle | ||
Une dos rectángulos para crear un objeto Rectangle nuevo, y rellena los espacios horizontal y vertical que quedan entre los dos rectángulos. | Rectangle | ||
|
Devuelve el valor simple del objeto especificado. | Object | |
bottom | propiedad |
bottomRight | propiedad |
bottomRight:Point| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La posición del ángulo inferior derecho del objeto Rectangle viene determinada por los valores right e bottom.
Implementación
public function get bottomRight():Point public function set bottomRight(value:Point):voidElementos de API relacionados
height | propiedad |
public var height:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La altura del rectángulo, en píxeles. El cambio del valor de height de un objeto Rectangle no afecta a las propiedades x, y y width.
Elementos de API relacionados
left | propiedad |
left:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La coordenada x del ángulo superior izquierdo del rectángulo. El cambio de la propiedad left de un objeto Rectangle no afecta a las propiedades y y height. Sin embargo, sí afecta a la propiedad width, mientras que cambiar el valor x no afecta a la propiedad width.
El valor de la propiedad letf es igual que el valor de la propiedad x.
Implementación
public function get left():Number public function set left(value:Number):voidElementos de API relacionados
right | propiedad |
size | propiedad |
size:Point| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El tamaño del objeto Rectangle, expresado como un objeto Point con valores width y height.
Implementación
public function get size():Point public function set size(value:Point):voidElementos de API relacionados
top | propiedad |
top:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La coordenada y del ángulo superior izquierdo del rectángulo. El cambio de la propiedad top de un objeto Rectangle no afecta a las propiedades x y width. Sin embargo, sí afecta a la propiedad height, mientras que cambiar el valor y no afecta a la propiedad height.
El valor de la propiedad top es igual que el valor de la propiedad y.
Implementación
public function get top():Number public function set top(value:Number):voidElementos de API relacionados
topLeft | propiedad |
topLeft:Point| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La posición del ángulo superior izquierdo del objeto Rectangle viene determinada por las coordenadas x e y del punto.
Implementación
public function get topLeft():Point public function set topLeft(value:Point):voidElementos de API relacionados
width | propiedad |
public var width:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La anchura del rectángulo, en píxeles. El cambio del valor de x de un objeto Rectangle no afecta a las propiedades y, width o height.
Elementos de API relacionados
x | propiedad |
public var x:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La coordenada x del ángulo superior izquierdo del rectángulo. El cambio del valor de la propiedad x de un objeto Rectangle no afecta a las propiedades y, width o height.
El valor de la propiedad x es igual que el valor de la propiedad left.
Elementos de API relacionados
y | propiedad |
public var y:Number| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La coordenada y del ángulo superior izquierdo del rectángulo. El cambio del valor de la propiedad y de un objeto Rectangle no afecta a las propiedades x, width o height.
El valor de la propiedad y es igual que el valor de la propiedad top.
Elementos de API relacionados
Rectangle | () | Información sobre |
public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un nuevo objeto Rectangle con la esquina superior izquierda especificada por los parámetros x y y con los parámetros width y height especificados. Si llama a esta función sin que existan parámetros, se crea un rectángulo con las propiedades x, y, width y height definidas en 0.
x:Number (default = 0) | |
y:Number (default = 0) | |
width:Number (default = 0) | |
height:Number (default = 0) |
Elementos de API relacionados
clone | () | método |
public function clone():Rectangle| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve un objeto Rectangle nuevo con las mismas propiedades x, y, width y height que el objeto Rectangle original.
Rectangle — Devuelve un objeto Rectangle nuevo con las mismas propiedades x, y, width y height que el objeto Rectangle original.
|
Elementos de API relacionados
contains | () | método |
public function contains(x:Number, y:Number):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina si el punto especificado está incluido en la región rectangular definida por este objeto Rectangle.
Parámetros
x:Number — La coordenada x (posición horizontal) del punto.
| |
y:Number — La coordenada y (posición vertical) del punto.
|
Boolean — Un valor true si el objeto Rectangle contiene el punto especificado; en caso contrario, devuelve false.
|
Elementos de API relacionados
containsPoint | () | método |
public function containsPoint(point:Point):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina si el punto especificado está incluido en la región rectangular definida por este objeto Rectangle. Este método es similar al método Rectangle.contains(), con la salvedad de que toma un objeto Point como parámetro.
Parámetros
point:Point — El punto, representado por sus coordenadas x e y.
|
Boolean — Un valor true si el objeto Rectangle contiene el punto especificado; en caso contrario, devuelve false.
|
Elementos de API relacionados
containsRect | () | método |
public function containsRect(rect:Rectangle):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina si el objeto Rectangle especificado por el parámetro rect está contenido en este objeto Rectangle. Se considera que un rectángulo contiene otro si el segundo está completamente incluido dentro de los límites del primero.
Parámetros
rect:Rectangle — El objeto Rectangle que se comprueba.
|
Boolean — Un valor true si el objeto Rectangle especificado se incluye en este objeto Rectangle; en caso contrario devuelve false.
|
copyFrom | () | método |
public function copyFrom(sourceRect:Rectangle):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.0, Flash Lite 4 |
Copia todos los datos del rectángulo desde el objeto Rectangle de origen en el objeto Rectangle de llamada.
Parámetros
sourceRect:Rectangle — El objeto Rectangle desde el que se van a copiar los datos.
|
equals | () | método |
public function equals(toCompare:Rectangle):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina si el objeto especificado en el parámetro toCompare es igual a este objeto Rectangle. Este método compara las propiedades x, y, width y height de un objeto con las de este objeto Rectangle.
Parámetros
toCompare:Rectangle — El rectángulo que desea comparar con este objeto Rectangle.
|
Boolean — Un valor true si el objeto tiene exactamente los mismos valores en las propiedades x, y, width y height que este objeto Rectángulo; en caso contrario, devuelve false.
|
Elementos de API relacionados
inflate | () | método |
public function inflate(dx:Number, dy:Number):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Player 9, Flash Lite 4 |
Expande el objeto Rectangle según las cantidades especificadas en píxeles. El punto central del objeto Rectangle permanece igual y su tamaño aumenta hacia la izquierda y la derecha en función del valor dx y hacia arriba y abajo según el valor dy.
Parámetros
dx:Number — El valor que se añadirá a la izquierda y derecha del objeto Rectangle. La ecuación que se utiliza para calcular la nueva anchura y la posición del rectángulo es la siguiente:
x -= dx;
width += 2 * dx;
| |
dy:Number — El valor que se añadirá por arriba y por abajo del objeto Rectangle. La ecuación que se utiliza para calcular la nueva altura y la posición del rectángulo es la siguiente:
y -= dy;
height += 2 * dy;
|
Elementos de API relacionados
inflatePoint | () | método |
public function inflatePoint(point:Point):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aumenta el tamaño del objeto Rectangle. Este método es similar al método Rectangle.inflate(), con la salvedad de que toma un objeto Point como parámetro.
Los siguientes dos ejemplos de código logran el mismo resultado:
var rect1:Rectangle = new Rectangle(0,0,2,5);
rect1.inflate(2,2)
var rect1:Rectangle = new Rectangle(0,0,2,5);
var pt1:Point = new Point(2,2);
rect1.inflatePoint(pt1)
Parámetros
point:Point — La propiedad x de este objeto Point se utiliza para aumentar la dimensión horizontal del objeto Rectangle. La propiedad y se utiliza para aumentar la dimensión vertical del objeto Rectangle.
|
Elementos de API relacionados
intersection | () | método |
public function intersection(toIntersect:Rectangle):Rectangle| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Si el objeto Rectangle especificado en el parámetro toIntersect presenta un punto de intersección con este objeto Rectangle, devuelve el área de intersección como un objeto Rectangle. Si los rectángulos no presentan un punto de intersección, este método devuelve un objeto Rectangle vacío con las propiedades definidas en 0.
Parámetros
toIntersect:Rectangle — El objeto Rectangle que quiere comparar para determinar si presenta un punto de intersección con este objeto Rectangle.
|
Rectangle — Un objeto Rectangle igual al área de intersección. Si los rectángulos no presentan un punto de intersección, este método devuelve un objeto Rectangle vacío con las propiedades x, y, width y height definidas como 0.
|
intersects | () | método |
public function intersects(toIntersect:Rectangle):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina si el objeto especificado en el parámetro toIntersect presenta un punto de intersección con este objeto Rectangle. Este método comprueba las propiedades x, y, width y height del objeto Rectangle especificado para determinar si presenta un punto de intersección con este objeto Rectangle.
Parámetros
toIntersect:Rectangle — El objeto Rectangle que se va a comparar con este objeto Rectangle.
|
Boolean — Un valor true si el objeto especificado presenta un punto de intersección con este objeto Rectangle; en caso contrario, devuelve false.
|
Elementos de API relacionados
isEmpty | () | método |
public function isEmpty():Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina si este objeto Rectangle está vacío o no.
Valor devueltoBoolean — Un valor true si la anchura o altura del objeto Rectangle es inferior o igual a 0, en caso contrario, devuelve false.
|
offset | () | método |
public function offset(dx:Number, dy:Number):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ajusta la posición del objeto Rectangle, definida por su ángulo superior izquierdo, según las cantidades especificadas.
Parámetros
dx:Number — Desplaza el valor x del objeto Rectangle según esta cantidad.
| |
dy:Number — Desplaza el valor y del objeto Rectangle según esta cantidad.
|
offsetPoint | () | método |
public function offsetPoint(point:Point):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ajusta la ubicación del objeto Rectangle utilizando un objeto Point como parámetro. Este método es similar al método Rectangle.offset(), con la salvedad de que toma un objeto Point como parámetro.
Parámetros
point:Point — Un objeto Point que se va a utilizar para desplazar este objeto Rectangle.
|
Elementos de API relacionados
setEmpty | () | método |
public function setEmpty():void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Establece todas las propiedades del objeto Rectangle en 0. Un objeto Rectangle está vacío si su anchura o su altura es igual o menor que 0.
Este método establece los valores de las propiedades x, y, width y height en 0.
Elementos de API relacionados
setTo | () | método |
public function setTo(xa:Number, ya:Number, widtha:Number, heighta:Number):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 11, AIR 3.0, Flash Lite 4 |
Define los miembros del rectángulo en los valores especificados
Parámetros
xa:Number — los valores para definir el rectángulo.
| |
ya:Number | |
widtha:Number | |
heighta:Number |
toString | () | método |
public function toString():String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea y devuelve una cadena en la que se indican las posiciones horizontal y vertical, así como la anchura y la altura, del objeto Rectangle.
Valor devueltoString — Una cadena con el valor de cada una de las siguientes propiedades del objeto Rectangle: x, y, width y height.
|
Elementos de API relacionados
union | () | método |
public function union(toUnion:Rectangle):Rectangle| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Une dos rectángulos para crear un objeto Rectangle nuevo, y rellena los espacios horizontal y vertical que quedan entre los dos rectángulos.
Nota: el método union() omitirá rectángulos con 0 como valor de altura o anchura, por ejemplo: var rect2:Rectangle = new Rectangle(300,300,50,0);
Parámetros
toUnion:Rectangle — El objeto Rectangle que se va a añadir a este objeto Rectangle.
|
Rectangle — Un nuevo objeto Rectangle que es la unión de los dos rectángulos.
|
trace() para confirmar que las instancias de Rectangle se han creado correctamente. Una variable Boolean isContained se asigna al resultado de la llamada al método containsRect(), lo que determina que el segundo rectángulo no encierra por completo al tercero.
package {
import flash.display.Sprite;
import flash.geom.Rectangle;
public class RectangleExample extends Sprite {
public function RectangleExample() {
var firstRect:Rectangle = new Rectangle();
trace(firstRect); // (x=0, y=0, w=0, h=0)
var secondRect:Rectangle = new Rectangle(1, 3, 11, 13);
trace(secondRect); // (x=1, y=3, w=11, h=13)
var thirdRect:Rectangle = new Rectangle(5, 8, 17, 19);
trace(thirdRect); // (x=5, y=8, w=17, h=19)
var isContained:Boolean = secondRect.containsRect(thirdRect);
trace(isContained); // false
}
}
}
Tue Jun 12 2018, 02:12 PM Z