| Pakiet | flash.geom |
| Klasa | public class Rectangle |
| Dziedziczenie | Rectangle  Object |
| Podklasy | RoundedRectangle |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Właściwości x, y, width oraz height klasy Rectangle są niezależne od siebie nawzajem; zmiana wartości jednej właściwości nie ma wpływu na pozostałe. Jednak właściwości right i bottom są wewnętrznie powiązane z powyższymi czterema właściwościami. Na przykład zmiana wartości właściwości right spowoduje zmianę wartości właściwości width; zmiana właściwości bottom spowoduje zmianę wartości właściwości height.
Obiekty Rectangle są używane w następujących metodach i właściwościach:
- metodach
applyFilter(),colorTransform(),copyChannel(),copyPixels(),draw(),fillRect(),generateFilterRect(),getColorBoundsRect(),getPixels(),merge(),paletteMap(),pixelDisolve(),setPixels()ithreshold()oraz właściwościrectklasy BitmapData; - metodach
getBounds()igetRect()oraz właściwościachscrollRectiscale9Gridklasy DisplayObject; - metodzie
getCharBoundaries()klasy TextField; - właściwości
pixelBoundsklasy Transform; - parametrze
boundsmetodystartDrag()klasy Sprite; - parametrze
printAreametodyaddPage()klasy PrintJob.
Do utworzenia obiektu Rectangle można użyć konstruktora new Rectangle().
Uwaga: Klasa Rectangle nie definiuje prostokątnego obiektu wyświetlanego klasy Shape. Aby narysować na ekranie prostokątny obiekt klasy Shape, należy użyć metody drawRect() klasy Graphics.
Powiązane elementy interfejsu API
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()
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| bottom : Number
Suma właściwości y i height. | Rectangle | ||
| bottomRight : Point
Położenie prawego dolnego rogu obiektu Rectangle, określone przez wartości właściwości right i bottom. | Rectangle | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| height : Number
Wysokość prostokąta w pikselach. | Rectangle | ||
| left : Number
Współrzędna x lewego górnego rogu prostokąta. | Rectangle | ||
| right : Number
Suma właściwości x i width. | Rectangle | ||
| size : Point
Rozmiar obiektu Rectangle, wyrażony za pomocą obiektu Point o określonej wysokości i szerokości. | Rectangle | ||
| top : Number
Współrzędna y lewego górnego rogu prostokąta. | Rectangle | ||
| topLeft : Point
Położenie lewego górnego rogu obiektu Rectangle, określone przez współrzędne x i y punktu. | Rectangle | ||
| width : Number
Szerokość prostokąta w pikselach. | Rectangle | ||
| x : Number
Współrzędna x lewego górnego rogu prostokąta. | Rectangle | ||
| y : Number
Współrzędna y lewego górnego rogu prostokąta. | Rectangle | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
Tworzy nowy obiekt Rectangle, który reprezentuje obszar prostokątny o podanym lewym górnym punkcie narożnym określonym parametrami x i y oraz o podanej wysokości i podanej szerokości. | Rectangle | ||
Zwraca nowy obiekt Rectangle o tych samych wartościach właściwości x, y, width i height, które miał oryginalny obiekt Rectangle. | Rectangle | ||
Pozwala sprawdzić, czy określony punkt jest zawarty w prostokątnym regionie zdefiniowanym przez ten obiekt Rectangle. | Rectangle | ||
Pozwala sprawdzić, czy określony punkt jest zawarty w prostokątnym regionie zdefiniowanym przez ten obiekt Rectangle. | Rectangle | ||
Pozwala sprawdzić, czy obiekt typu Rectangle wskazany parametrem rect zawiera się w tym obiekcie Rectangle. | Rectangle | ||
Kopiuje wszystkie dane prostokąta ze źródłowego obiektu Rectangle do wywołującego obiektu Rectangle. | Rectangle | ||
Pozwala sprawdzić, czy obiekt wskazany w parametrze toCompare jest równy temu obiektowi Rectangle. | Rectangle | ||
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
Zwiększa rozmiar obiektu Rectangle na podstawie podanej liczby pikseli. | Rectangle | ||
Zwiększa rozmiar obiektu Rectangle. | Rectangle | ||
Jeśli obiekt Rectangle określony w parametrze toIntersect przecina się z tym obiektem Rectangle, zwraca część wspólną jako obiekt Rectangle. | Rectangle | ||
Pozwala sprawdzić, czy obiekt wskazany w parametrze toIntersect przecina się z tym obiektem Rectangle. | Rectangle | ||
Określa, czy dany obiekt Rectangle jest pusty. | Rectangle | ||
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Zmienia o określone wartości położenie obiektu Rectangle wyznaczane przez jego lewy górny narożnik. | Rectangle | ||
Modyfikuje położenie obiektu Rectangle, jako parametru używając obiektu Point. | Rectangle | ||
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
Ustawia wszystkie właściwości obiektu Rectangle na 0. | Rectangle | ||
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
Ustawia określone wartości elementów obiektu Rectangle.
| Rectangle | ||
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
Tworzy i zwraca ciąg znaków zawierający współrzędne poziome i pionowe oraz wysokość i szerokość obiektu Rectangle. | Rectangle | ||
Dodaje dwa prostokąty w celu utworzenia nowego obiektu Rectangle. Dodawanie realizowane jest poprzez wypełnienie przestrzeni poziomej i pionowej między dwoma prostokątami. | Rectangle | ||
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
bottom | właściwość |
bottomRight | właściwość |
bottomRight:Point| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Położenie prawego dolnego rogu obiektu Rectangle, określone przez wartości właściwości right i bottom.
Implementacja
public function get bottomRight():Point public function set bottomRight(value:Point):voidPowiązane elementy interfejsu API
height | właściwość |
left | właściwość |
left:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Współrzędna x lewego górnego rogu prostokąta. Zmiana wartości left obiektu Rectangle nie ma wpływu na właściwości y i height Ma jednak wpływ na właściwość width, natomiast zmiana wartości x nie wpływa na właściwość width.
Wartość właściwości left jest równa wartości właściwości x.
Implementacja
public function get left():Number public function set left(value:Number):voidPowiązane elementy interfejsu API
right | właściwość |
size | właściwość |
size:Point| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Rozmiar obiektu Rectangle wyrażony jako obiekt typu punkt z wartościami właściwości width i height.
Implementacja
public function get size():Point public function set size(value:Point):voidPowiązane elementy interfejsu API
top | właściwość |
top:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Współrzędna y lewego górnego rogu prostokąta. Zmiana wartości top obiektu Rectangle nie ma wpływu na właściwości x i width Ma jednak wpływ na właściwość height, natomiast zmiana wartości y nie wpływa na właściwość height.
Wartość właściwości top jest równa wartości właściwości y.
Implementacja
public function get top():Number public function set top(value:Number):voidPowiązane elementy interfejsu API
topLeft | właściwość |
topLeft:Point| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Położenie lewego górnego rogu obiektu Rectangle, określone przez współrzędne x i y punktu.
Implementacja
public function get topLeft():Point public function set topLeft(value:Point):voidPowiązane elementy interfejsu API
width | właściwość |
x | właściwość |
public var x:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Współrzędna x lewego górnego rogu prostokąta. Zmiana wartości właściwości x obiektu Rectangle nie ma wpływu na właściwości y, width i height.
Wartość właściwości x jest równa wartości właściwości left.
Powiązane elementy interfejsu API
y | właściwość |
public var y:Number| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Współrzędna y lewego górnego rogu prostokąta. Zmiana wartości właściwości y obiektu Rectangle nie ma wpływu na właściwości x, width i height.
Wartość właściwości y jest równa wartości właściwości top.
Powiązane elementy interfejsu API
Rectangle | () | Konstruktor |
public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy nowy obiekt Rectangle, którego lewy górny róg jest określony przez parametry x i y, oraz o szerokości i wysokości określonej parametrami width i height. Wywołanie tej funkcji bez parametrów powoduje utworzenie prostokąta z właściwościami x, y, width i height równymi 0.
x:Number (default = 0) | |
y:Number (default = 0) | |
width:Number (default = 0) | |
height:Number (default = 0) |
Powiązane elementy interfejsu API
clone | () | metoda |
public function clone():Rectangle| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwraca nowy obiekt Rectangle o tych samych wartościach właściwości x, y, width i height, które miał oryginalny obiekt Rectangle.
Rectangle — Nowy obiekt Rectangle o tych samych wartościach właściwości x, y, width i height, które miał oryginalny obiekt Rectangle.
|
Powiązane elementy interfejsu API
contains | () | metoda |
public function contains(x:Number, y:Number):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Pozwala sprawdzić, czy określony punkt jest zawarty w prostokątnym obszarze zdefiniowanym przez ten obiekt Rectangle.
Parametry
x:Number — Współrzędna x (pozycja pozioma) punktu.
| |
y:Number — Współrzędna u (pozycja pionowa) punktu.
|
Boolean — Wartość true, jeśli obiekt Rectangle zawiera określony punkt; w przeciwnym razie false.
|
Powiązane elementy interfejsu API
containsPoint | () | metoda |
public function containsPoint(point:Point):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Pozwala sprawdzić, czy określony punkt jest zawarty w prostokątnym regionie zdefiniowanym przez ten obiekt Rectangle. Ta metoda jest podobna do metody Rectangle.contains(), z tym że jej parametrem jest obiekt typu Point.
Parametry
point:Point — Punkt reprezentowany przez współrzędne x i y.
|
Boolean — Wartość true, jeśli obiekt Rectangle zawiera określony punkt; w przeciwnym razie false.
|
Powiązane elementy interfejsu API
containsRect | () | metoda |
public function containsRect(rect:Rectangle):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Pozwala sprawdzić, czy obiekt typu Rectangle wskazany parametrem rect zawiera się w tym obiekcie Rectangle. Uznaje się, że jeden obiekt Rectangle zawiera drugi, jeśli ten drugi obiekt znajduje się w całości w granicach pierwszego.
Parametry
rect:Rectangle — Sprawdzany obiekt Rectangle.
|
Boolean — Wartość true, jeśli określony obiekt Rectangle jest zawarty w tym obiekcie Rectangle; w przeciwnym razie false.
|
copyFrom | () | metoda |
public function copyFrom(sourceRect:Rectangle):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.0, Flash Lite 4 |
Kopiuje wszystkie dane prostokąta ze źródłowego obiektu Rectangle do wywołującego obiektu Rectangle.
Parametry
sourceRect:Rectangle — Obiekt Rectangle, z którego należy skopiować dane.
|
equals | () | metoda |
public function equals(toCompare:Rectangle):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Pozwala sprawdzić, czy obiekt wskazany w parametrze toCompare jest równy temu obiektowi Rectangle. Ta metoda porównuje właściwości x, y, width i height obiektu z odpowiednimi właściwościami tego obiektu Rectangle.
Parametry
toCompare:Rectangle — Prostokąt, który ma być porównywany z tym obiektem Rectangle.
|
Boolean — Wartość true, jeśli obiekt ma dokładnie te same wartości właściwości x, y, width i height, co ten obiekt Rectangle; w przeciwnym razie false.
|
Powiązane elementy interfejsu API
inflate | () | metoda |
public function inflate(dx:Number, dy:Number):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Player 9, Flash Lite 4 |
Zwiększa rozmiar obiektu Rectangle na podstawie podanej liczby pikseli. Punkt środkowy obiektu Rectangle pozostaje niezmieniony, a prostokąt jest powiększany po lewej i po prawej stronie o wartość dx oraz u góry i u dołu o wartość dy.
Parametry
dx:Number — Wartość, jaka ma być dodana po lewej i prawej stronie obiektu Rectangle. Nowa szerokość i pozycja prostokąta jest obliczana z następującego równania:
x -= dx;
width += 2 * dx;
| |
dy:Number — Wartość, jaka ma być dodana u góry i dołu obiektu Rectangle. Nowa wysokość i pozycja prostokąta jest obliczana z następującego równania:
y -= dy;
height += 2 * dy;
|
Powiązane elementy interfejsu API
inflatePoint | () | metoda |
public function inflatePoint(point:Point):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zwiększa rozmiar obiektu Rectangle. Ta metoda jest podobna do metody Rectangle.inflate(), z tym że jej parametrem jest obiekt typu Point.
Następujące dwa przykładowe fragmenty kodu odnoszą ten sam skutek:
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)
Parametry
point:Point — Właściwość x tego obiektu Point służy do zwiększania wymiaru poziomego obiektu Rectangle. Właściwość y służy do zwiększania wymiaru pionowego obiektu Rectangle.
|
Powiązane elementy interfejsu API
intersection | () | metoda |
public function intersection(toIntersect:Rectangle):Rectangle| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Jeśli obiekt Rectangle określony w parametrze toIntersect przecina się z tym obiektem Rectangle, zwraca część wspólną jako obiekt Rectangle. Jeśli prostokąty nie przecinają się, ta metoda zwraca pusty obiekt Rectangle ze wszystkimi właściwościami ustawionymi na 0.
Parametry
toIntersect:Rectangle — Obiekt Rectangle, z którym należy przeprowadzić porównanie w celu sprawdzenia, czy nie przecina się z tym obiektem Rectangle.
|
Rectangle — Obiekt Rectangle równy części wspólnej. Jeśli prostokąty się nie przecinają, ta metoda zwraca pusty obiekt Rectangle, tj. prostokąt, którego właściwości x, y, width i height są równe 0.
|
intersects | () | metoda |
public function intersects(toIntersect:Rectangle):Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Pozwala sprawdzić, czy obiekt wskazany w parametrze toIntersect przecina się z tym obiektem Rectangle. Ta metoda sprawdza właściwości x, y, width i height określonego obiektu Rectangle, aby ustalić, czy przecina się on z tym obiektem Rectangle.
Parametry
toIntersect:Rectangle — Obiekt Rectangle, który ma być porównywany z tym obiektem Rectangle.
|
Boolean — Wartość true, jeśli określony obiekt przecina się z tym obiektem Rectangle; w przeciwnym razie false.
|
Powiązane elementy interfejsu API
isEmpty | () | metoda |
public function isEmpty():Boolean| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Określa, czy dany obiekt Rectangle jest pusty.
ZwracaBoolean — Wartość true, jeśli szerokość lub wysokość obiektu Rectangle jest mniejsza lub równa 0; w przeciwnym razie wartość false.
|
offset | () | metoda |
public function offset(dx:Number, dy:Number):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Zmienia o określone wartości położenie obiektu Rectangle wyznaczane przez jego lewy górny narożnik.
Parametry
dx:Number — Zmienia wartość x obiektu Rectangle o podaną wartość.
| |
dy:Number — Zmienia wartość y obiektu Rectangle o podaną wartość.
|
offsetPoint | () | metoda |
public function offsetPoint(point:Point):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Modyfikuje położenie obiektu Rectangle, jako parametru używając obiektu Point. Ta metoda jest podobna do metody Rectangle.offset(), z tym że jej parametrem jest obiekt typu Point.
Parametry
point:Point — Obiekt Point, który ma być używany do modyfikacji położenia tego obiektu Rectangle.
|
Powiązane elementy interfejsu API
setEmpty | () | metoda |
public function setEmpty():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Ustawia wszystkie właściwości obiektu Rectangle na 0. Obiekt Rectangle jest pusty, jeśli jego wysokość lub szerokość jest mniejsza lub równa 0.
Ta metoda przypisuje wartość 0 właściwościom x, y, width i height.
Powiązane elementy interfejsu API
setTo | () | metoda |
public function setTo(xa:Number, ya:Number, widtha:Number, heighta:Number):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11, AIR 3.0, Flash Lite 4 |
Ustawia określone wartości elementów obiektu Rectangle.
Parametry
xa:Number — Wartości, które należy ustawić dla prostokąta.
| |
ya:Number | |
widtha:Number | |
heighta:Number |
toString | () | metoda |
public function toString():String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Tworzy i zwraca ciąg zawierający współrzędne poziome i pionowe oraz wysokość i szerokość obiektu Rectangle.
ZwracaString — Ciąg znaków z listą wartości następujących właściwości obiektu Rectangle: x, y, width i height.
|
Powiązane elementy interfejsu API
union | () | metoda |
public function union(toUnion:Rectangle):Rectangle| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Dodaje dwa prostokąty w celu utworzenia nowego obiektu Rectangle. Dodawanie realizowane jest przez wypełnienie przestrzeni poziomej i pionowej między dwoma prostokątami.
Uwaga: Metodaunion() ignoruje prostokąty o wysokości lub szerokości 0, np.: var rect2:Rectangle = new Rectangle(300,300,50,0);
Parametry
toUnion:Rectangle — Obiekt Rectangle, który ma być dodany do tego obiektu Rectangle.
|
Rectangle — Nowy obiekt Rectangle będący sumą dwóch prostokątów.
|
trace() w celu potwierdzenia pomyślnego utworzenia instancji klasy Rectangle. Teraz wynikowi wywołania metody containsRect() jest przypisywana zmienna typu Boolean isContained. Metoda ta ustala, że drugi prostokąt nie zawiera w całości trzeciego prostokąta.
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, 12:06 PM Z