Rectangle

Pacote	flash.geom
Classe	public class Rectangle
Herança	Rectangle Object
Subclasses	RoundedRectangle

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Um objeto Rectangle é uma área definida por sua posição, conforme indicado pelo seu ponto no canto superior esquerdo (x, y) e pela sua largura e altura.

As propriedades x, y, width e height da classe Rectangle são independentes umas das outras; alterar o valor de uma propriedade não surte efeito nas outras. Entretanto, as propriedades right e bottom são integralmente relacionadas a essas quatros propriedades. Por exemplo, se você alterar o valor da propriedade right, o valor da propriedade width muda; se você alterar a propriedade bottom, o valor da propriedade height muda.

Os métodos e propriedades a seguir usam objetos Rectangle:

Métodos applyFilter(), colorTransform(), copyChannel(), copyPixels(), draw(), fillRect(), generateFilterRect(), getColorBoundsRect(), getPixels(), merge(), paletteMap(), pixelDisolve(), setPixels() e threshold(), e a propriedade rect da classe BitmapData
Métodos getBounds() e getRect() e as propriedades scrollRect e scale9Grid da classe DisplayObject
Método getCharBoundaries() da classe TextField
Propriedade pixelBounds da classe Transform
Parâmetro bounds do método startDrag() da classe Sprite
Parâmetro printArea do método addPage() da classe PrintJob

É possível usar o construtor new Rectangle() para criar um objeto Rectangle.

Observação: A classe Rectangle não define um objeto de exibição Shape retangular. Para desenhar um objeto Shape retangular na tela, use o método drawRect() da classe Graphics.

Veja os exemplos

Elementos da API relacionados

flash.display.DisplayObject.scrollRect
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()

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		bottom : Number Soma das propriedades y e height.	Rectangle
		bottomRight : Point A localização do canto inferior direito do objeto Rectangle, determinada pelos valores das propriedades inferior e direita.	Rectangle
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		height : Number Altura do retângulo, em pixels.	Rectangle
		left : Number Coordenada x do canto superior esquerdo do retângulo.	Rectangle
		right : Number Soma das propriedades x e width.	Rectangle
		size : Point Tamanho do objeto Rectangle, expresso como um objeto Point com os valores das propriedades de largura e altura.	Rectangle
		top : Number Coordenada y do canto superior esquerdo do retângulo.	Rectangle
		topLeft : Point A localização do canto superior esquerdo do objeto Rectangle, determinada pelas coordenadas x e y do ponto.	Rectangle
		width : Number Largura do retângulo, em pixels.	Rectangle
		x : Number Coordenada x do canto superior esquerdo do retângulo.	Rectangle
		y : Number Coordenada y do canto superior esquerdo do retângulo.	Rectangle

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0) Cria um novo objeto Rectangle com o canto superior esquerdo especificado pelos parâmetros x e y e com os parâmetros de largura e altura especificados.	Rectangle
		clone():Rectangle Retorna um novo objeto Rectangle com os mesmos valores das propriedades x, y, width e height que o objeto Rectangle original.	Rectangle
		contains(x:Number, y:Number):Boolean Determina se o ponto especificado está contido na região retangular definida por este objeto Rectangle.	Rectangle
		containsPoint(point:Point):Boolean Determina se o ponto especificado está contido na região retangular definida por este objeto Rectangle.	Rectangle
		containsRect(rect:Rectangle):Boolean Determina se o objeto Rectangle especificado pelo parâmetro rect está contido neste objeto Rectangle.	Rectangle
		copyFrom(sourceRect:Rectangle):void Copia todos os dados de retângulo do objeto de origem Rectangle para o objeto de chamada Rectangle que chama.	Rectangle
		equals(toCompare:Rectangle):Boolean Determina se o objeto especificado no parâmetro toCompare é igual a este objeto Rectangle.	Rectangle
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		inflate(dx:Number, dy:Number):void Aumenta o tamanho do objeto Rectangle de acordo com as intensidades especificadas, em pixels.	Rectangle
		inflatePoint(point:Point):void Aumenta o tamanho do objeto Rectangle.	Rectangle
		intersection(toIntersect:Rectangle):Rectangle Se o objeto Rectangle especificado no parâmetro toIntersect fizer interseção com este objeto Rectangle, ele retorna a área da interseção como um objeto Rectangle.	Rectangle
		intersects(toIntersect:Rectangle):Boolean Determina se o objeto especificado no parâmetro toIntersect faz interseção com este objeto Rectangle.	Rectangle
		isEmpty():Boolean Determina se este objeto Rectangle está ou não vazio.	Rectangle
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		offset(dx:Number, dy:Number):void Ajusta a localização do objeto Rectangle, conforme determinado pelo seu canto superior esquerdo, pelas intensidades especificadas.	Rectangle
		offsetPoint(point:Point):void Ajusta a localização do objeto Rectangle usando um objeto Point como parâmetro.	Rectangle
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		setEmpty():void Define todas as propriedades do objeto Rectangle como 0.	Rectangle
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		setTo(xa:Number, ya:Number, widtha:Number, heighta:Number):void Estabelece os integrantes do Rectangle para os valores especificados	Rectangle
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String Cria e retorna uma string que lista as posições horizontal e vertical e a largura e altura do objeto Rectangle.	Rectangle
		union(toUnion:Rectangle):Rectangle Adiciona dois retângulos para criar um novo objeto Rectangle, preenchendo os espaços horizontal e vertical entre os dois retângulos.	Rectangle
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object

Detalhes da propriedade

bottom

propriedade

bottom:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Soma das propriedades y e height.

Imagem de retângulo que mostra as propriedades de localização e medida.

Implementação
public function get bottom():Number
public function set bottom(value:Number):void

Elementos da API relacionados

y
height

bottomRight

propriedade

bottomRight:Point

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

A localização do canto inferior direito do objeto Rectangle, determinada pelos valores das propriedades right e bottom.

Imagem de retângulo que mostra as propriedades de localização e medida.

Implementação
public function get bottomRight():Point
public function set bottomRight(value:Point):void

Elementos da API relacionados

flash.geom.Point

height

propriedade

public var height:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Altura do retângulo, em pixels. Alterar o valor de heightde um objeto Rectangle não surte efeito nas propriedades x, y e width.

Imagem de retângulo que mostra as propriedades de localização e medida.

Elementos da API relacionados

x
y
height

left

propriedade

left:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Coordenada x do canto superior esquerdo do retângulo. Alterar a propriedade left de um objeto Rectangle não surte efeito nas propriedades y e height. Entretanto, ela afeta a propriedade width, enquanto que alterar o valor x não afeta a propriedade width.

O valor da propriedade left é igual ao valor da propriedade x.

Imagem de retângulo que mostra as propriedades de localização e medida.

Implementação
public function get left():Number
public function set left(value:Number):void

Elementos da API relacionados

x
y
width
height

right

propriedade

right:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Soma das propriedades x e width.

Imagem de retângulo que mostra as propriedades de localização e medida.

Implementação
public function get right():Number
public function set right(value:Number):void

Elementos da API relacionados

x
width

size

propriedade

size:Point

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Tamanho do objeto Rectangle, expresso como um objeto Point com os valores das propriedades width e height.

Implementação
public function get size():Point
public function set size(value:Point):void

Elementos da API relacionados

flash.geom.Point

top

propriedade

top:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Coordenada y do canto superior esquerdo do retângulo. Alterar a propriedade top de um objeto Rectangle não surte efeito nas propriedades x e width. Entretanto, ela afeta a propriedade height, enquanto que alterar o valor y não afeta a propriedade height.

O valor da propriedade top é igual ao valor da propriedade y.

Imagem de retângulo que mostra as propriedades de localização e medida.

Implementação
public function get top():Number
public function set top(value:Number):void

Elementos da API relacionados

x
y
width
height

topLeft

propriedade

topLeft:Point

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

A localização do canto superior esquerdo do objeto Rectangle, determinada pelas coordenadas x e y do ponto.

Imagem de retângulo que mostra as propriedades de localização e medida.

Implementação
public function get topLeft():Point
public function set topLeft(value:Point):void

Elementos da API relacionados

flash.geom.Point
x
y

width

propriedade

public var width:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Largura do retângulo, em pixels. Alterar o valor de widthde um objeto Rectangle não surte efeito nas propriedades x, y e height.

Imagem de retângulo que mostra as propriedades de localização e medida.

Elementos da API relacionados

x
y
height

x

propriedade

public var x:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Coordenada x do canto superior esquerdo do retângulo. Alterar o valor da propriedade x de um objeto Rectangle não surte efeito nas propriedades y, width e height.

O valor da propriedade x é igual ao valor da propriedade left.

Elementos da API relacionados

left

y

propriedade

public var y:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Coordenada y do canto superior esquerdo do retângulo. Alterar o valor da propriedade y de um objeto Rectangle não surte efeito nas propriedades x, width e height.

O valor da propriedade y é igual ao valor da propriedade top.

Elementos da API relacionados

x
width
height
top

Detalhes do construtor

()

Construtor

public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Cria um novo objeto Rectangle com o canto superior esquerdo especificado pelos parâmetros x e y e com os parâmetros width e height especificados. Se você chamar esta função sem parâmetros, um retângulo com as propriedades x, y, width e height definido como 0 é criado.

Parâmetros

	`x:Number` (default = `0`) — Coordenada x do canto superior esquerdo do retângulo.

	`y:Number` (default = `0`) — Coordenada y do canto superior esquerdo do retângulo.

	`width:Number` (default = `0`) — Largura do retângulo, em pixels.

	`height:Number` (default = `0`) — Altura do retângulo, em pixels.

Elementos da API relacionados

x
y
width
height

Detalhes do método

clone

()

método

public function clone():Rectangle

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Retorna um novo objeto Rectangle com os mesmo valores das propriedades x, y, width e height que o objeto Rectangle original.

Retorna

Rectangle — Um novo objeto Rectangle com os mesmo valores das propriedades x, y, width e height que o objeto Rectangle original.

Elementos da API relacionados

x
y
width
height

contains

()

método

public function contains(x:Number, y:Number):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina se o ponto especificado está contido na região retangular definida por este objeto Rectangle.

Parâmetros

	`x:Number` — Coordenada x (posição horizontal) do ponto.

	`y:Number` — Coordenada y (posição vertical) do ponto.

Retorna

Boolean — O valor será true se o objeto Rectangle contiver o ponto especificado; caso contrário, será false.

Elementos da API relacionados

flash.geom.Point

containsPoint

()

método

public function containsPoint(point:Point):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina se o ponto especificado está contido na região retangular definida por este objeto Rectangle. Este método é parecido com o método Rectangle.contains(), exceto que ele considera o objeto Point como parâmetro.

Parâmetros

point:Point — Ponto, conforme representado por suas coordenadas x e y.

Retorna

Boolean — O valor será true se o objeto Rectangle contiver o ponto especificado; caso contrário, será false.

Elementos da API relacionados

contém()
flash.geom.Point

containsRect

()

método

public function containsRect(rect:Rectangle):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina se o objeto Rectangle especificado pelo parâmetro rect está contido neste objeto Rectangle. Considera-se que um objeto Rectangle contém outro se o segundo objeto Rectangle ficar totalmente dentro dos limites do primeiro.

Parâmetros

rect:Rectangle — Objeto Rectangle que está sendo verificado.

Retorna

Boolean — O valor será true se o objeto Rectangle especificado estiver contido no objeto Rectangle; caso contrário, será false.

copyFrom

()

método

public function copyFrom(sourceRect:Rectangle):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 11, AIR 3.0, Flash Lite 4

Copia todos os dados de retângulo do objeto de origem Rectangle para o objeto de chamada Rectangle que chama.

Parâmetros

sourceRect:Rectangle — O objeto Rectangle a partir do qual os dados são copiados.

equals

()

método

public function equals(toCompare:Rectangle):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina se o objeto especificado no parâmetro toCompare é igual a este objeto Rectangle. Este método compara as propriedades x, y, width e height de um objeto com as mesmas propriedades deste Rectangle.

Parâmetros

toCompare:Rectangle — Retângulo para comparar com esse objeto Rectangle.

Retorna

Boolean — O valor será true se o objeto tiver exatamente os mesmos valores para as propriedades x, y, width e height que esse objeto Rectangle; caso contrário, será false.

Elementos da API relacionados

x
y
width
height

inflate

()

método

public function inflate(dx:Number, dy:Number):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Player 9, Flash Lite 4

Aumenta o tamanho do objeto Rectangle de acordo com as intensidades especificadas, em pixels. O ponto central do objeto Rectangle continua o mesmo, e seu tamanho aumenta para a esquerda e para a direita pelo dx e para cima e para baixo pelo valor dy.

Parâmetros

	`dx:Number` — Valor a ser adicionado à esquerda e à direita do objeto Rectangle. A equação a seguir é usada para calcular a nova largura e posição do retângulo: x -= dx; width += 2 * dx;

	`dy:Number` — Valor a ser adicionado à parte superior e à parte inferior do Rectangle. A equação a seguir é usada para calcular a nova altura e posição do retângulo: y -= dy; height += 2 * dy;

Elementos da API relacionados

x
y

inflatePoint

()

método

public function inflatePoint(point:Point):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Aumenta o tamanho do objeto Rectangle. Este método é parecido com o método Rectangle.inflate(), exceto que ele considera o objeto Point como parâmetro.

Os dois exemplos de código a seguir fornecem o mesmo 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 — A propriedade x deste objeto Point é usada para aumentar a dimensão horizontal do objeto Rectangle. A propriedade y é usada para aumentar a dimensão vertical do objeto Rectangle.

Elementos da API relacionados

flash.geom.Point

intersection

()

método

public function intersection(toIntersect:Rectangle):Rectangle

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Se o objeto Rectangle especificado no parâmetro toIntersect fizer interseção com este objeto Rectangle, ele retorna a área da interseção como um objeto Rectangle. Se os retângulos não fizerem interseção, este método retorna um objeto Rectangle com suas propriedades definidas como 0.

Retângulo de interseção resultante.

Parâmetros

toIntersect:Rectangle — Objeto Rectangle a ser comparado para ser se faz interseção com este objeto Rectangle.

Retorna

Rectangle — Objeto Rectangle que se iguala à área de interseção. Se os retângulos não fizerem interseção, este método retornará um objeto Rectangle vazio; ou seja, um retângulo com suas propriedades x, y, width e height definidas como 0.

intersects

()

método

public function intersects(toIntersect:Rectangle):Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina se o objeto especificado no parâmetro toIntersect faz interseção com este objeto Rectangle. Este método verifica as propriedades x, y, width e height do objeto Rectangle especificado para ver se ele faz interseção com este objeto Rectangle.

Parâmetros

toIntersect:Rectangle — Objeto Rectangle a ser comparado com este objeto Rectangle.

Retorna

Boolean — O valor será true se o objeto especificado fizer interseção com o objeto Rectangle; caso contrário, será false.

Elementos da API relacionados

x
y
width
height

isEmpty

()

método

public function isEmpty():Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Determina se este objeto Rectangle está ou não vazio.

Retorna

Boolean — O valor será true se a largura ou a altura do objeto Rectangle for menor ou igual a 0; caso contrário, este valor será false.

offset

()

método

public function offset(dx:Number, dy:Number):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Ajusta a localização do objeto Rectangle, conforme determinado pelo seu canto superior esquerdo, pelas intensidades especificadas.

Parâmetros

	`dx:Number` — Move o valor x do objeto Rectangle por sua intensidade.

	`dy:Number` — Move o valor y do objeto Rectangle por sua intensidade.

offsetPoint

()

método

public function offsetPoint(point:Point):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Ajusta a localização do objeto Rectangle usando um objeto Point como parâmetro. Este método é parecido com o método Rectangle.offset(), exceto que ele considera o objeto Point como parâmetro.

Parâmetros

point:Point — Objeto Point a ser usado para deslocar este objeto Rectangle.

Elementos da API relacionados

flash.geom.Point

setEmpty

()

método

public function setEmpty():void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Define todas as propriedades do objeto Rectangle como 0. Um objeto Rectangle ficará vazio se sua largura ou altura for menor ou igual a 0.

Este método define os valores das propriedades x, y, width e height como 0.

Elementos da API relacionados

x
y
width
height

setTo

()

método

public function setTo(xa:Number, ya:Number, widtha:Number, heighta:Number):void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 11, AIR 3.0, Flash Lite 4

Estabelece os integrantes do Rectangle para os valores especificados

Parâmetros

	`xa:Number` — os valores para estabelecer o retângulo.

	`ya:Number`

	`widtha:Number`

	`heighta:Number`

toString

()

método

public function toString():String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Cria e retorna uma string que lista as posições horizontal e vertical e a largura e altura do objeto Rectangle.

Retorna

String — String que lista o valor de cada uma das propriedades a seguir do objeto Rectangle: x, y, width e height.

Elementos da API relacionados

x
y
width
height

union

()

método

public function union(toUnion:Rectangle):Rectangle

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0, Flash Player 9, Flash Lite 4

Adiciona dois retângulos para criar um novo objeto Rectangle, preenchendo os espaços horizontal e vertical entre os dois retângulos.

Retângulo da união resultante.

Observação: o método union() não ignora retângulos com 0 como valor de altura ou largura, como: var rect2:Rectangle = new Rectangle(300,300,50,0);

Parâmetros

toUnion:Rectangle — Objeto Rectangle a ser adicionado a este objeto Rectangle.

Retorna

Rectangle — Novo objeto Rectangle que é a união de dois retângulos.

Exemplos Como usar este exemplo

RectangleExample.as

O exemplo a seguir usa a classe RectangleExample para criar três novos objetos Rectangle em várias coordenadas x,y e com várias alturas e larguras e depois usa o método trace() para confirmar que as ocorrências Rectangle foram criadas com êxito. Depois, uma variável booliana isContained é atribuída ao resultado da chamada para o método containsRect(), que determina que o segundo retângulo não inclui completamente o terceiro retângulo.

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
        }
    }
}

Aspectos jurídicos | Política de privacidade on-line

Rectangle - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote flash.geom

bottom

bottomRight

height

left

right

size

top

topLeft

width

x

y

Rectangle

clone

contains

containsPoint

containsRect

copyFrom

equals

inflate

inflatePoint

intersection

intersects

isEmpty

offset

offsetPoint

setEmpty

setTo

toString

union