| Apéndices | Convenciones | Marcos
| Paquete | flash.geom |
| Clase | public class Rectangle |
| Herencia | Rectangle  Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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:
applyFilter(), colorTransform(), copyChannel(), copyPixels(), draw(), fillRect(), generateFilterRect(), getColorBoundsRect(), getPixels(), merge(), paletteMap(), pixelDisolve(), setPixels() y threshold(), y la propiedad rect de la clase BitmapData.getBounds() y getRect(), y las propiedades scrollRect y scale9Grid de la clase DisplayObject.getCharBoundaries() de la clase TextField.pixelBounds de la clase Transform.bounds para el método startDrag() de la clase Sprite.printArea del método addPage() 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.
Véase también
| 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 | ||
| prototype : Object
[static]
Una referencia al objeto prototipo de una clase u objeto de función.
| Object | |
| 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 | ||
|
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 | |
|
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 |
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadasbottom:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Suma de las propiedades y y height.
public function get bottom():Number
public function set bottom(value:Number):void
Véase también
| bottomRight | propiedad |
bottomRight:Point [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
La posición del ángulo inferior derecho del objeto Rectangle viene determinada por los valores right e bottom.
public function get bottomRight():Point
public function set bottomRight(value:Point):void
Véase también
| height | propiedad |
public var height:Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
Véase también
| left | propiedad |
left:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
public function get left():Number
public function set left(value:Number):void
Véase también
| right | propiedad |
right:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Suma de las propiedades x y width.
public function get right():Number
public function set right(value:Number):void
Véase también
| size | propiedad |
size:Point [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
El tamaño del objeto Rectangle, expresado como un objeto Point con valores width y height.
public function get size():Point
public function set size(value:Point):void
Véase también
| top | propiedad |
top:Number [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
public function get top():Number
public function set top(value:Number):void
Véase también
| topLeft | propiedad |
topLeft:Point [read-write]
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
La posición del ángulo superior izquierdo del objeto Rectangle viene determinada por las coordenadas x e y del punto.
public function get topLeft():Point
public function set topLeft(value:Point):void
Véase también
| width | propiedad |
public var width:Number
| Versión del reproductor: | Flash Player 9 |
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.
Véase también
| x | propiedad |
public var x:Number
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
Véase también
| y | propiedad |
public var y:Number
| Versión del reproductor: | Flash Player 9 |
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.
Véase también
| Rectangle | () | constructor |
public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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) |
Véase también
| clone | () | método |
public function clone():Rectangle
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| contains | () | método |
public function contains(x:Number, y:Number):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| containsPoint | () | método |
public function containsPoint(point:Point):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| containsRect | () | método |
public function containsRect(rect:Rectangle):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
| equals | () | método |
public function equals(toCompare:Rectangle):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| inflate | () | método |
public function inflate(dx:Number, dy:Number):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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; |
Véase también
| inflatePoint | () | método |
public function inflatePoint(point:Point):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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:
rect1=new flash.geom.Rectangle(0,0,2,5); rect1.inflate(2,2)
rect1=new flash.geom.Rectangle(0,0,2,5); pt1=new flash.geom.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.
|
Véase también
| intersection | () | método |
public function intersection(toIntersect:Rectangle):Rectangle
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| intersects | () | método |
public function intersects(toIntersect:Rectangle):Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| isEmpty | () | método |
public function isEmpty():Boolean
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| offsetPoint | () | método |
public function offsetPoint(point:Point):void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| setEmpty | () | método |
public function setEmpty():void
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
Véase también
| toString | () | método |
public function toString():String
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
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.
|
Véase también
| union | () | método |
public function union(toUnion:Rectangle):Rectangle
| Versión del lenguaje: | ActionScript 3.0 |
| Versión del reproductor: | Flash Player 9 |
Une dos rectángulos para crear un objeto Rectangle nuevo, y rellena los espacios horizontal y vertical que quedan entre los dos rectángulos.
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.
|
Véase también
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
}
}
}
Enviarme un mensaje de correo electrónico cuando se añadan comentarios a esta página | Informe de comentarios
Página actual: http://livedocs.adobe.com/flash/9.0_es/ActionScriptLangRefV3/flash/geom/Rectangle.html