| 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 |
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()ethreshold(), e a propriedaderectda classe BitmapData - Métodos
getBounds()egetRect()e as propriedadesscrollRectescale9Gridda classe DisplayObject - Método
getCharBoundaries()da classe TextField - Propriedade
pixelBoundsda classe Transform - Parâmetro
boundsdo métodostartDrag()da classe Sprite - Parâmetro
printAreado métodoaddPage()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.
Elementos da 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 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étodo | Definido por | ||
|---|---|---|---|
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 | ||
Retorna um novo objeto Rectangle com os mesmos valores das propriedades x, y, width e height que o objeto Rectangle original. | Rectangle | ||
Determina se o ponto especificado está contido na região retangular definida por este objeto Rectangle. | Rectangle | ||
Determina se o ponto especificado está contido na região retangular definida por este objeto Rectangle. | Rectangle | ||
Determina se o objeto Rectangle especificado pelo parâmetro rect está contido neste objeto Rectangle. | Rectangle | ||
Copia todos os dados de retângulo do objeto de origem Rectangle para o objeto de chamada Rectangle que chama. | Rectangle | ||
Determina se o objeto especificado no parâmetro toCompare é igual a este objeto Rectangle. | Rectangle | ||
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
Aumenta o tamanho do objeto Rectangle de acordo com as intensidades especificadas, em pixels. | Rectangle | ||
Aumenta o tamanho do objeto 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 | ||
Determina se o objeto especificado no parâmetro toIntersect faz interseção com este objeto Rectangle. | Rectangle | ||
Determina se este objeto Rectangle está ou não vazio. | Rectangle | ||
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
Ajusta a localização do objeto Rectangle, conforme determinado pelo seu canto superior esquerdo, pelas intensidades especificadas. | Rectangle | ||
Ajusta a localização do objeto Rectangle usando um objeto Point como parâmetro. | Rectangle | ||
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
Define todas as propriedades do objeto Rectangle como 0. | Rectangle | ||
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
Estabelece os integrantes do Rectangle para os valores especificados
| Rectangle | ||
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
Cria e retorna uma string que lista as posições horizontal e vertical e a largura e altura do objeto 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 | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
bottom | propriedade |
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.
Implementação
public function get bottomRight():Point public function set bottomRight(value:Point):voidElementos da API relacionados
height | propriedade |
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.
Implementação
public function get left():Number public function set left(value:Number):voidElementos da API relacionados
right | propriedade |
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):voidElementos da API relacionados
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.
Implementação
public function get top():Number public function set top(value:Number):voidElementos da API relacionados
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.
Implementação
public function get topLeft():Point public function set topLeft(value:Point):voidElementos da API relacionados
width | propriedade |
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
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
Rectangle | () | 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.
x:Number (default = 0) | |
y:Number (default = 0) | |
width:Number (default = 0) | |
height:Number (default = 0) |
Elementos da API relacionados
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.
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
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.
|
Boolean — O valor será true se o objeto Rectangle contiver o ponto especificado; caso contrário, será false.
|
Elementos da API relacionados
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.
|
Boolean — O valor será true se o objeto Rectangle contiver o ponto especificado; caso contrário, será false.
|
Elementos da API relacionados
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.
|
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.
|
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
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
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
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.
Parâmetros
toIntersect:Rectangle — Objeto Rectangle a ser comparado para ser se faz interseção com este objeto Rectangle.
|
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.
|
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
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.
RetornaBoolean — 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
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
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.
RetornaString — String que lista o valor de cada uma das propriedades a seguir do objeto Rectangle: x, y, width e height.
|
Elementos da API relacionados
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.
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.
|
Rectangle — Novo objeto Rectangle que é a união de dois retângulos.
|
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
}
}
}
Wed Jun 13 2018, 11:10 AM Z