| Pacchetto | flash.geom |
| Classe | public class Rectangle |
| Ereditarietà | Rectangle  Object |
| Sottoclassi | RoundedRectangle |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Le proprietà x, y, width e height della classe Rectangle sono indipendenti e, quindi, la modifica del valore di una proprietà non ha alcun effetto sulle altre. Le proprietà right e bottom, invece, sono integralmente correlate alle quattro proprietà precedenti. Ad esempio, se modificate il valore della proprietà right, il valore della proprietà width cambia; se modificate la proprietà bottom, cambia il valore della proprietà height.
Gli oggetti Rectangle vengono utilizzati dai seguenti metodi e proprietà:
- I metodi
applyFilter(),colorTransform(),copyChannel(),copyPixels(),draw(),fillRect(),generateFilterRect(),getColorBoundsRect(),getPixels(),merge(),paletteMap(),pixelDisolve(),setPixels()ethreshold()e la proprietàrectdella classe BitmapData. - I metodi
getBounds()egetRect()e le proprietàscrollRectescale9Griddella classe DisplayObject. - Il metodo
getCharBoundaries()della classe TextField. - La proprietà
pixelBoundsdella classe Transform. - Il parametro
boundsper il metodostartDrag()della classe Sprite. - Il parametro
printAreadel metodoaddPage()della classe PrintJob.
Per creare un oggetto Rectangle potete utilizzare la funzione di costruzione new Rectangle().
Nota: la classe Rectangle non definisce un oggetto di visualizzazione Shape rettangolare. Per disegnare un oggetto Shape rettangolare sullo schermo, utilizzate il metodo drawRect() della classe Graphics.
Altri esempi
Ricerca di unioni e intersezioni di oggetti Rectangle
Impostazione delle dimensioni, della scala e dell'orientamento
Altre informazioni
Elementi API correlati
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()
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| bottom : Number
La somma delle proprietà y e height. | Rectangle | ||
| bottomRight : Point
La posizione dell'angolo inferiore destro dell'oggetto Rectangle determinata dai valori delle proprietà right e bottom. | Rectangle | ||
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| height : Number
L'altezza del rettangolo espressa in pixel. | Rectangle | ||
| left : Number
La coordinata x dell'angolo superiore sinistro del rettangolo. | Rectangle | ||
| right : Number
La somma delle proprietà x e width. | Rectangle | ||
| size : Point
Le dimensioni dell'oggetto Rectangle, espresse sotto forma di oggetto Point con i valori delle proprietà width e height. | Rectangle | ||
| top : Number
La coordinata y dell'angolo superiore sinistro del rettangolo. | Rectangle | ||
| topLeft : Point
La posizione dell'angolo superiore sinistro dell'oggetto Rectangle determinata dalle coordinate x e y del punto. | Rectangle | ||
| width : Number
La larghezza del rettangolo espressa in pixel. | Rectangle | ||
| x : Number
La coordinata x dell'angolo superiore sinistro del rettangolo. | Rectangle | ||
| y : Number
La coordinata y dell'angolo superiore sinistro del rettangolo. | Rectangle | ||
| Metodo | Definito da | ||
|---|---|---|---|
Crea un nuovo oggetto Rectangle con l'angolo superiore sinistro specificato dai parametri x e y e con i parametri width e height impostati. | Rectangle | ||
Restituisce un nuovo oggetto Rectangle con gli stessi valori delle proprietà x, y, width e height dell'oggetto Rectangle originale. | Rectangle | ||
Determina se il punto specificato è contenuto nell'area rettangolare definita dall'oggetto Rectangle. | Rectangle | ||
Determina se il punto specificato è contenuto nell'area rettangolare definita dall'oggetto Rectangle. | Rectangle | ||
Determina se l'oggetto Rectangle specificato dal parametro rect è contenuto in questo oggetto Rectangle. | Rectangle | ||
Copia tutti i dati del rettangolo dall'oggetto Rectangle di origine all'oggetto Rectangle chiamante. | Rectangle | ||
Determina se l'oggetto specificato nel parametro toCompare è uguale a questo oggetto Rectangle. | Rectangle | ||
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
Aumenta le dimensioni dell'oggetto Rectangle della misura specificata in pixel. | Rectangle | ||
Aumenta le dimensioni dell'oggetto Rectangle. | Rectangle | ||
Se l'oggetto Rectangle specificato nel parametro toIntersect si interseca con questo oggetto Rectangle, restituisce l'area dell'intersezione come oggetto Rectangle. | Rectangle | ||
Determina se l'oggetto specificato nel parametro toIntersect interseca questo oggetto Rectangle. | Rectangle | ||
Determina se questo oggetto Rectangle è vuoto o meno. | Rectangle | ||
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
Rettifica la posizione dell'oggetto Rectangle in relazione all'angolo superiore sinistro, in base ai valori specificati. | Rectangle | ||
Rettifica la posizione dell'oggetto Rectangle utilizzando come parametro un oggetto Point. | Rectangle | ||
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
Imposta su 0 tutte le proprietà dell'oggetto Rectangle. | Rectangle | ||
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
Imposta i membri dell'oggetto Rectangle sui valori specificati.
| Rectangle | ||
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
Crea e restituisce una stringa che elenca la posizione orizzontale e verticale e la larghezza e l'altezza dell'oggetto Rectangle. | Rectangle | ||
Combina due rettangoli per creare un nuovo oggetto Rectangle, riempiendo lo spazio orizzontale e verticale tra due rettangoli. | Rectangle | ||
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
bottom | proprietà |
bottomRight | proprietà |
bottomRight:Point| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La posizione dell'angolo inferiore destro dell'oggetto Rectangle determinata dai valori delle proprietà right e bottom.
Implementazione
public function get bottomRight():Point public function set bottomRight(value:Point):voidElementi API correlati
height | proprietà |
public var height:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
L'altezza del rettangolo espressa in pixel. La modifica del valore height di un oggetto Rectangle non ha alcun effetto sulle proprietà x, y e width.
Altri esempi
Elementi API correlati
left | proprietà |
left:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La coordinata x dell'angolo superiore sinistro del rettangolo. La modifica della proprietà left di un oggetto Rectangle non ha alcun effetto sulle proprietà y e height; essa incide tuttavia sulla proprietà width, mentre la modifica del valore x non altera la proprietà width.
Il valore della proprietà left è uguale al valore della proprietà x.
Implementazione
public function get left():Number public function set left(value:Number):voidAltri esempi
Elementi API correlati
right | proprietà |
size | proprietà |
size:Point| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Le dimensioni dell'oggetto Rectangle, espresse sotto forma di oggetto Point con valori delle proprietà width e height.
Implementazione
public function get size():Point public function set size(value:Point):voidElementi API correlati
top | proprietà |
top:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La coordinata y dell'angolo superiore sinistro del rettangolo. La modifica della proprietà top di un oggetto Rectangle non ha effetti sulle proprietà x e width; essa incide tuttavia sulla proprietà height, mentre la modifica del valore y non altera la proprietà height.
Il valore della proprietà top è uguale al valore della proprietà y.
Implementazione
public function get top():Number public function set top(value:Number):voidAltri esempi
Elementi API correlati
topLeft | proprietà |
topLeft:Point| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La posizione dell'angolo superiore sinistro dell'oggetto Rectangle determinata dalle coordinate x e y del punto.
Implementazione
public function get topLeft():Point public function set topLeft(value:Point):voidElementi API correlati
width | proprietà |
public var width:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La larghezza del rettangolo espressa in pixel. La modifica del valore width di un oggetto Rectangle non ha alcun effetto sulle proprietà x, y e height.
Altri esempi
Elementi API correlati
x | proprietà |
public var x:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La coordinata x dell'angolo superiore sinistro del rettangolo. La modifica del valore della proprietà x dell'oggetto Rectangle non ha alcun effetto sulle proprietà y, width e height.
Il valore della proprietà x è uguale al valore della proprietà left.
Altri esempi
Elementi API correlati
y | proprietà |
public var y:Number| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La coordinata y dell'angolo superiore sinistro del rettangolo. La modifica del valore della proprietà y dell'oggetto Rectangle non ha alcun effetto sulle proprietà x, width e height.
Il valore della proprietà y è uguale al valore della proprietà top.
Altri esempi
Elementi API correlati
Rectangle | () | Funzione di costruzione |
public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea un nuovo oggetto Rectangle con l'angolo superiore sinistro specificato dai parametri x e y e con i parametri width e height impostati. Se chiamate questa funzione di costruzione senza fornire parametri, viene creato un rettangolo con le proprietà x, y, width e height impostate su 0.
x:Number (default = 0) | |
y:Number (default = 0) | |
width:Number (default = 0) | |
height:Number (default = 0) |
Elementi API correlati
clone | () | metodo |
public function clone():Rectangle| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Restituisce un nuovo oggetto Rectangle con gli stessi valori delle proprietà x, y, width e height dell'oggetto Rectangle originale.
Rectangle — Un nuovo oggetto Rectangle con gli stessi valori delle proprietà x, y, width e height dell'oggetto Rectangle originale.
|
Elementi API correlati
contains | () | metodo |
public function contains(x:Number, y:Number):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se il punto specificato è contenuto nell'area rettangolare definita dall'oggetto Rectangle.
Parametri
x:Number — La coordinata x (posizione orizzontale) del punto.
| |
y:Number — La coordinata y (posizione verticale) del punto.
|
Boolean — Un valore true se l'oggetto Rectangle contiene il punto specificato; false in caso contrario.
|
Elementi API correlati
containsPoint | () | metodo |
public function containsPoint(point:Point):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se il punto specificato è contenuto nell'area rettangolare definita dall'oggetto Rectangle. Questo metodo è simile al metodo Rectangle.contains(), ma utilizza un oggetto Point come parametro.
Parametri
point:Point — Il punto rappresentato dalle sue coordinate x e y.
|
Boolean — Un valore true se l'oggetto Rectangle contiene il punto specificato; false in caso contrario.
|
Elementi API correlati
containsRect | () | metodo |
public function containsRect(rect:Rectangle):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se l'oggetto Rectangle specificato dal parametro rect è contenuto in questo oggetto Rectangle. Si dice che un oggetto Rectangle ne contiene un altro se il secondo oggetto Rectangle rientra completamente nei limiti del primo.
Parametri
rect:Rectangle — L'oggetto Rectangle da controllare.
|
Boolean — Un valore true se l'oggetto Rectangle specificato è contenuto in questo oggetto Rectangle; false in caso contrario.
|
copyFrom | () | metodo |
public function copyFrom(sourceRect:Rectangle):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3.0, Flash Lite 4 |
Copia tutti i dati del rettangolo dall'oggetto Rectangle di origine all'oggetto Rectangle chiamante.
Parametri
sourceRect:Rectangle — L'oggetto Rectangle da cui copiare i dati.
|
equals | () | metodo |
public function equals(toCompare:Rectangle):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se l'oggetto specificato nel parametro toCompare è uguale a questo oggetto Rectangle. Questo metodo confronta le proprietà x, y, width e height di un oggetto con le proprietà dell'oggetto Rectangle.
Parametri
toCompare:Rectangle — Il rettangolo da confrontare con questo oggetto Rectangle.
|
Boolean — Un valore true se l'oggetto ha esattamente gli stessi valori per le proprietà x, y, width e height dell'oggetto Rectangle; false in caso contrario.
|
Elementi API correlati
inflate | () | metodo |
public function inflate(dx:Number, dy:Number):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Player 9, Flash Lite 4 |
Aumenta le dimensioni dell'oggetto Rectangle della misura specificata in pixel. Il punto centrale dell'oggetto Rectangle rimane invariato, ma le dimensioni di destra e sinistra aumentano di un valore pari a dx e quelle superiori e inferiori di un valore pari a dy.
Parametri
dx:Number — Il valore da aggiungere a sinistra e a destra dell'oggetto Rectangle. Per calcolare la nuova larghezza e posizione del rettangolo viene utilizzata la seguente equazione:
x -= dx;
width += 2 * dx;
| |
dy:Number — Il valore da aggiungere alle dimensioni superiore e inferiore dell'oggetto Rectangle. Per calcolare la nuova altezza e posizione del rettangolo viene utilizzata la seguente equazione:
y -= dy;
height += 2 * dy;
|
Altri esempi
Elementi API correlati
inflatePoint | () | metodo |
public function inflatePoint(point:Point):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Aumenta le dimensioni dell'oggetto Rectangle. Questo metodo è simile al metodo Rectangle.inflate(), ma utilizza un oggetto Point come parametro.
Con i due esempi di codice che seguono si ottiene lo stesso risultato:
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)
Parametri
point:Point — Per aumentare la dimensione orizzontale dell'oggetto Rectangle viene utilizzata la proprietà x di questo oggetto Point. Per aumentare la dimensione verticale dell'oggetto Rectangle viene utilizzata la proprietà y.
|
Altri esempi
Elementi API correlati
intersection | () | metodo |
public function intersection(toIntersect:Rectangle):Rectangle| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se l'oggetto Rectangle specificato nel parametro toIntersect si interseca con questo oggetto Rectangle, restituisce l'area dell'intersezione come oggetto Rectangle. Se i rettangoli non si intersecano, questo metodo restituisce un oggetto Rectangle vuoto con le proprietà impostate su 0.
Parametri
toIntersect:Rectangle — L'oggetto Rectangle che si desidera confrontare per verificare se interseca questo oggetto Rectangle.
|
Rectangle — Un oggetto Rectangle uguale all'area di intersezione. Se i rettangoli non si intersecano, questo metodo restituisce un oggetto Rectangle vuoto, ovvero un rettangolo con le proprietà x, y, width e height impostate su 0.
|
Altri esempi
intersects | () | metodo |
public function intersects(toIntersect:Rectangle):Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se l'oggetto specificato nel parametro toIntersect nterseca questo oggetto Rectangle. Questo metodo controlla le proprietà x, y, width e height dell'oggetto Rectangle specificato per verificare se interseca questo oggetto Rectangle.
Parametri
toIntersect:Rectangle — L'oggetto Rectangle da confrontare con questo oggetto Rectangle.
|
Boolean — Un valore true se l'oggetto specificato interseca l'oggetto Rectangle; false in caso contrario.
|
Altri esempi
Elementi API correlati
isEmpty | () | metodo |
public function isEmpty():Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina se questo oggetto Rectangle è vuoto o meno.
RestituisceBoolean — Se la larghezza o l'altezza dell'oggetto Rectangle è uguale o inferiore a 0, restituisce true; altrimenti restituisce false.
|
offset | () | metodo |
public function offset(dx:Number, dy:Number):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Rettifica la posizione dell'oggetto Rectangle in relazione all'angolo superiore sinistro, in base ai valori specificati.
Parametri
dx:Number — Sposta il valore x dell'oggetto Rectangle in base a questo valore.
| |
dy:Number — Sposta il valore y dell'oggetto Rectangle in base a questo valore.
|
Altri esempi
offsetPoint | () | metodo |
public function offsetPoint(point:Point):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Rettifica la posizione dell'oggetto Rectangle utilizzando come parametro un oggetto Point. Questo metodo è simile al metodo Rectangle.offset(), ma utilizza un oggetto Point come parametro.
Parametri
point:Point — L'oggetto Point da utilizzare per l'offset di questo oggetto Rectangle.
|
Altri esempi
Elementi API correlati
setEmpty | () | metodo |
public function setEmpty():void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Imposta su 0 tutte le proprietà dell'oggetto Rectangle. Un oggetto Rectangle è vuoto se il valore della proprietà width o height è uguale o inferiore a 0.
Questo metodo imposta i valori delle proprietà x, y, width e height su 0.
Elementi API correlati
setTo | () | metodo |
public function setTo(xa:Number, ya:Number, widtha:Number, heighta:Number):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 11, AIR 3.0, Flash Lite 4 |
Imposta i membri dell'oggetto Rectangle sui valori specificati.
Parametri
xa:Number — I valori su cui impostare il rettangolo.
| |
ya:Number | |
widtha:Number | |
heighta:Number |
toString | () | metodo |
public function toString():String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Crea e restituisce una stringa che elenca la posizione orizzontale e verticale e la larghezza e l'altezza dell'oggetto Rectangle.
RestituisceString — Una stringa che elenca il valore di ognuna delle seguenti proprietà dell'oggetto Rectangle: x, y, width e height.
|
Elementi API correlati
union | () | metodo |
public function union(toUnion:Rectangle):Rectangle| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Combina due rettangoli per creare un nuovo oggetto Rectangle, riempiendo lo spazio orizzontale e verticale tra due rettangoli.
Nota: il metodo union() ignora i rettangoli con 0 come valore di altezza o larghezza, quali var rect2:Rectangle = new Rectangle(300,300,50,0);
Parametri
toUnion:Rectangle — Un oggetto Rectangle da aggiungere a questo oggetto Rectangle.
|
Rectangle — Un nuovo oggetto Rectangle che rappresenta l'unione dei due rettangoli.
|
Altri esempi
trace() per verificare che le istanze di Rectangle siano state create correttamente. Viene quindi assegnata una variabile booleana isContained al risultato della chiamata al metodo containsRect(), che determina che il secondo rettangolo non racchiude completamente il terzo rettangolo.
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:44 PM Z