flash.geom.Rectangle (ActionScript 3.0)

	Eigenschaft	Definiert von
		bottom : Number Die Summe der Eigenschaften y und height.	Rectangle
		bottomRight : Point Die Position der rechten unteren Ecke des Rectangle-Objekts, definiert durch die Werte der Eigenschaften right und bottom.	Rectangle
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		height : Number Die Höhe des Rechtecks in Pixel.	Rectangle
		left : Number Die x-Koordinate der linken oberen Ecke des Rechtecks.	Rectangle
		prototype : Object [static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.	Object
		right : Number Die Summe der Eigenschaften x und width.	Rectangle
		size : Point Die Größe des Rectangle-Objekts, ausgedrückt als Point-Objekt, mit den Werten der Eigenschaften width und height.	Rectangle
		top : Number Die y-Koordinate der linken oberen Ecke des Rechtecks.	Rectangle
		topLeft : Point Die Position der linken oberen Ecke des Rectangle-Objekts, die durch den x- und y-Wert des Punkts angegeben wird.	Rectangle
		width : Number Die Breite des Rechtecks in Pixel.	Rectangle
		x : Number Die x-Koordinate der linken oberen Ecke des Rechtecks.	Rectangle
		y : Number Die y-Koordinate der linken oberen Ecke des Rechtecks.	Rectangle

	Methode	Definiert von
		Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0) Erstellt ein neues Rectangle-Objekt mit der angegebenen Breite und Höhe, dessen linke obere Ecke durch die Parameter x und y festgelegt ist.	Rectangle
		clone():Rectangle Gibt ein neues Rectangle-Objekt mit denselben Werten für die Eigenschaften "x", "y", "width" und "height" wie die des ursprünglichen Rectangle-Objekts zurück.	Rectangle
		contains(x:Number, y:Number):Boolean Legt fest, ob der angegebene Punkt innerhalb des rechteckigen Bereichs liegt, der durch das Rectangle-Objekt definiert ist.	Rectangle
		containsPoint(point:Point):Boolean Legt fest, ob der angegebene Punkt innerhalb des rechteckigen Bereichs liegt, der durch das Rectangle-Objekt definiert ist.	Rectangle
		containsRect(rect:Rectangle):Boolean Legt fest, ob sich das von dem Parameter "rect" angegebene Rectangle-Objekt innerhalb dieses Rectangle-Objekts befindet.	Rectangle
		equals(toCompare:Rectangle):Boolean Legt fest, ob das im Parameter "toCompare" angegebene Objekt und dieses Rectangle-Objekt gleich sind.	Rectangle
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		inflate(dx:Number, dy:Number):void Vergrößert das Rectangle-Objekt in Pixel um die angegebenen Werte.	Rectangle
		inflatePoint(point:Point):void Ändert die Größe des Rectangle-Objekts.	Rectangle
		intersection(toIntersect:Rectangle):Rectangle Wenn sich das im Parameter toIntersect angegebene Rectangle-Objekt mit diesem Rectangle-Objekt überschneidet, gibt die Methode die Schnittfläche als Rectangle-Objekt zurück.	Rectangle
		intersects(toIntersect:Rectangle):Boolean Legt fest, ob sich das im Parameter "toIntersect" angegebene Objekt mit diesem Rectangle-Objekt überschneidet.	Rectangle
		isEmpty():Boolean Legt fest, ob dieses Rectangle-Objekt leer ist.	Rectangle
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		offset(dx:Number, dy:Number):void Ändert die Position des Rectangle-Objekts ausgehend von seiner oberen linken Ecke um die angegebenen Beträge.	Rectangle
		offsetPoint(point:Point):void Ändert die Position des Rectangle-Objekts, wobei ein Point-Objekt als Parameter dient.	Rectangle
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setEmpty():void Setzt alle Eigenschaften des Rectangle-Objekts auf 0.	Rectangle
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toString():String Erstellt und übergibt einen String, der die horizontalen und vertikalen Positionen sowie die Breite und Höhe des Rectangle-Objekts enthält.	Rectangle
		union(toUnion:Rectangle):Rectangle Vereinigt zwei Rechtecke miteinander, indem der vertikale und horizontale Bereich zwischen ihnen gefüllt wird, so dass ein neues Rectangle-Objekt entsteht.	Rectangle
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Eigenschaftsdetail

bottom

Eigenschaft

bottom:Number [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die Summe der Eigenschaften y und height.

Implementierung
public function get bottom():Number
public function set bottom(value:Number):void

Siehe auch

y
height
Verwenden von Rectangle-Objekten

bottomRight

Eigenschaft

bottomRight:Point [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die Position der rechten unteren Ecke des Rectangle-Objekts, die durch die Werte der Eigenschaften right und bottom angegeben wird.

Implementierung
public function get bottomRight():Point
public function set bottomRight(value:Point):void

Siehe auch

flash.geom.Point

height

Eigenschaft

public var height:Number

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die Höhe des Rechtecks in Pixel. Änderungen des Werts height eines Rectangle-Objekts haben keinen Einfluss auf die Eigenschaften x, y und width.

Siehe auch

x
y
height
Verwenden von Rectangle-Objekten

left

Eigenschaft

left:Number [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die x-Koordinate der oberen linken Ecke des Rechtecks. Änderungen der Eigenschaft left eines Rectangle-Objekts wirken sich nicht auf die Eigenschaften y und height aus. Sie wirken sich jedoch auf die Eigenschaft width aus; Änderungen des Werts x betreffen dagegen nicht die Eigenschaft width.

Der Wert der Eigenschaft left entspricht dem Wert der Eigenschaft x.

Implementierung
public function get left():Number
public function set left(value:Number):void

Siehe auch

x
y
width
height
Verwenden von Rectangle-Objekten

right

Eigenschaft

right:Number [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die Summe der Eigenschaften x und width.

Implementierung
public function get right():Number
public function set right(value:Number):void

Siehe auch

x
width
Verwenden von Rectangle-Objekten

size

Eigenschaft

size:Point [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die Größe des Rectangle-Objekts, ausgedrückt als Point-Objekt, mit width- und height-Werten.

Implementierung
public function get size():Point
public function set size(value:Point):void

Siehe auch

flash.geom.Point

top

Eigenschaft

top:Number [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die y-Koordinate der linken oberen Ecke des Rechtecks. Änderungen der Eigenschaft top eines Rectangle-Objekts wirken sich nicht auf die Eigenschaften x und width aus. Sie wirken sich jedoch auf die Eigenschaft height aus; Änderungen des Werts y betreffen dagegen nicht die Eigenschaft height.

Der Wert der Eigenschaft top entspricht dem Wert der Eigenschaft y.

Implementierung
public function get top():Number
public function set top(value:Number):void

Siehe auch

x
y
width
height
Verwenden von Rectangle-Objekten

topLeft

Eigenschaft

topLeft:Point [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die Position der linken oberen Ecke des Rectangle-Objekts, die durch die x- und y-Koordinate des Punkts angegeben wird.

Implementierung
public function get topLeft():Point
public function set topLeft(value:Point):void

Siehe auch

flash.geom.Point
x
y

width

Eigenschaft

public var width:Number

Player-Version :

Flash Player 9

Die Breite des Rechtecks in Pixel. Änderungen des Werts width eines Rectangle-Objekts haben keinen Einfluss auf die Eigenschaften x, y und height.

Siehe auch

x
y
height
Verwenden von Rectangle-Objekten

Eigenschaft

public var x:Number

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Die x-Koordinate der oberen linken Ecke des Rechtecks. Änderungen des Werts der Eigenschaft x eines Rectangle-Objekts wirken sich nicht auf die Eigenschaften y, width und height aus.

Der Wert der Eigenschaft x entspricht dem Wert der Eigenschaft left.

Siehe auch

left
Verwenden von Rectangle-Objekten

Eigenschaft

public var y:Number

Player-Version :

Flash Player 9

Die y-Koordinate der linken oberen Ecke des Rechtecks. Änderungen des Werts der Eigenschaft y eines Rectangle-Objekts wirken sich nicht auf die Eigenschaften x, width und height aus.

Der Wert der Eigenschaft y entspricht dem Wert der Eigenschaft top.

Siehe auch

x
width
height
top
Verwenden von Rectangle-Objekten

Konstruktordetail

Rectangle

()

Konstruktor

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

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Erstellt ein neues Rectangle-Objekt, dessen linke obere Ecke durch die Parameter x und y festgelegt ist, und mit den angegebenen width- und height-Parametern. Wenn Sie diese Funktion ohne Parameter aufrufen, wird ein Rechteck erstellt, bei dem die Eigenschaftenx, y, width und height auf 0 gesetzt sind.

Parameter

	`x:Number` (default = `0`) — Die x-Koordinate der oberen linken Ecke des Rechtecks.

	`y:Number` (default = `0`) — Die y-Koordinate der linken oberen Ecke des Rechtecks.

	`width:Number` (default = `0`) — Die Breite des Rechtecks in Pixel.

	`height:Number` (default = `0`) — Die Höhe des Rechtecks in Pixel.

Siehe auch

x
y
width
height

Methodendetail

clone

()

Methode

public function clone():Rectangle

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Gibt ein neues Rectangle-Objekt mit den gleichen Werten x, y, width und height wie die des ursprünglichen Rectangle-Objekts zurück.

Rückgabewerte

Rectangle — Ein neues Rectangle-Objekt mit den gleichen Werten für die Eigenschaften x, y, width und height wie die des ursprünglichen Rectangle-Objekts.

Siehe auch

x
y
width
height

contains

()

Methode

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

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Legt fest, ob der angegebene Punkt innerhalb des rechteckigen Bereichs liegt, der durch das Rectangle-Objekt definiert ist.

Parameter

	`x:Number` — Die x-Koordinate (horizontale Position) des Punkts.

	`y:Number` — Die y-Koordinate (vertikale Position) des Punkts.

Rückgabewerte

Boolean — Der Wert true, wenn das Rectangle-Objekt den angegebenen Punkt enthält, andernfalls false.

Siehe auch

flash.geom.Point

containsPoint

()

Methode

public function containsPoint(point:Point):Boolean

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Legt fest, ob der angegebene Punkt innerhalb des rechteckigen Bereichs liegt, der durch das Rectangle-Objekt definiert ist. Diese Methode entspricht der Methode Rectangle.contains(), das Point-Objekt wird jedoch als Parameter angenommen.

Parameter

point:Point — Der Punkt, der durch die x- und y-Koordinaten angegeben wird.

Rückgabewerte

Boolean — Der Wert true, wenn das Rectangle-Objekt den angegebenen Punkt enthält, andernfalls false.

Siehe auch

contains()
flash.geom.Point

containsRect

()

Methode

public function containsRect(rect:Rectangle):Boolean

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Legt fest, ob sich das von dem Parameter rect angegebene Rectangle-Objekt innerhalb dieses Rectangle-Objekts befindet. Ein Rechteck enthält ein anderes Rechteck, wenn Letzteres vollständig innerhalb der Grenzen des Ersteren liegt.

Parameter

rect:Rectangle — Das überprüfte Rectangle-Objekt.

Rückgabewerte

Boolean — Der Wert true, wenn das angegebene Rectangle-Objekt in diesem Rectangle-Objekt enthalten ist, andernfalls false.

equals

()

Methode

public function equals(toCompare:Rectangle):Boolean

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Legt fest, ob das im Parameter toCompare angegebene Objekt und dieses Rectangle-Objekt gleich sind. Bei dieser Methode wird ein Objekt anhand der gleichen Eigenschaften x, y, width und height mit diesem Rectangle-Objekt verglichen.

Parameter

toCompare:Rectangle — Das Rechteck, das mit diesem Rectangle-Objekt verglichen werden soll.

Rückgabewerte

Boolean — Der Wert true wenn das Objekt exakt die gleichen Werte für die Parameter x, y, width und height aufweist wie dieses Rectangle-Objekt; andernfalls false.

Siehe auch

x
y
width
height

inflate

()

Methode

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

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Vergrößert das Rectangle-Objekt in Pixel um die angegebenen Werte. Der Mittelpunkt des Rectangle-Objekts bleibt gleich, und die Größe wird mit dem Wert dx nach links und rechts und mit dem Wert dy nach oben und unten erweitert.

Parameter

	`dx:Number` — Der Wert, der links und rechts zum Rectangle-Objekt addiert wird. Zur Berechnung der neuen Breite und Position des Rechtecks wird die folgende Gleichung verwendet: x -= dx; width += 2 * dx;

	`dy:Number` — Der Wert, der oben und unten zum Rectangle-Objekt addiert wird. Zur Berechnung der neuen Höhe und Position des Rechtecks wird die folgende Gleichung verwendet: y -= dy; height += 2 * dy;

Siehe auch

x
y
Verwenden von Rectangle-Objekten

inflatePoint

()

Methode

public function inflatePoint(point:Point):void

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Ändert die Größe des Rectangle-Objekts. Diese Methode ähnelt der Methode Rectangle.inflate(), als Parameter wird jedoch ein Point-Objekt verwendet.

Die folgenden beiden Codebeispiele führen zum gleichen Ergebnis:

  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)

Parameter

point:Point — Mit der x-Eigenschaft dieses Point-Objekts wird die horizontale Abmessung des Rectangle-Objekts vergrößert. Mit der y-Eigenschaft wird die vertikale Abmessung des Rectangle-Objekts vergrößert.

Siehe auch

flash.geom.Point
Verwenden von Rectangle-Objekten

intersection

()

Methode

public function intersection(toIntersect:Rectangle):Rectangle

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Wenn sich das im Parameter toIntersect angegebene Rectangle-Objekt mit diesem Rectangle-Objekt überschneidet, gibt die Methode die Schnittfläche als Rectangle-Objekt zurück. Wenn sich die Rechtecke nicht überschneiden, wird mit dieser Methode ein leeres Rectangle-Objekt zurückgegeben, dessen Eigenschaften auf 0 gesetzt sind.

Parameter

toIntersect:Rectangle — Das Rectangle-Objekt, bei dem überprüft werden soll, ob es sich mit diesem Rectangle-Objekt überschneidet.

Rückgabewerte

Rectangle — Ein Rectangle-Objekt, das der Schnittfläche entspricht. Wenn sich die Rechtecke nicht überschneiden, wird mit dieser Methode ein leeres Rectangle-Objekt zurückgegeben. Dabei handelt es sich um Rechteck, bei dem die Eigenschaften x, y, width und height auf 0 gesetzt sind.

Siehe auch

Verwenden von Rectangle-Objekten

intersects

()

Methode

public function intersects(toIntersect:Rectangle):Boolean

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Legt fest, ob sich das im Parameter toIntersect angegebene Objekt mit diesem Rectangle-Objekt überschneidet. Bei dieser Methode wird anhand der Eigenschaften x, y, width und height des angegebenen Rectangle-Objekts überprüft, ob es sich mit diesem Rectangle-Objekt überschneidet.

Parameter

toIntersect:Rectangle — Das Rectangle-Objekt, das mit diesem Rectangle-Objekt verglichen werden soll.

Rückgabewerte

Boolean — Der Wert true, wenn sich das angegebene Objekt mit dem Rectangle-Objekt überschneidet, andernfalls false.

Siehe auch

x
y
width
height
Verwenden von Rectangle-Objekten

isEmpty

()

Methode

public function isEmpty():Boolean

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Legt fest, ob dieses Rectangle-Objekt leer ist.

Rückgabewerte

Boolean — Der Wert true, wenn die Breite oder Höhe des Rectangle-Objekts kleiner oder gleich 0 ist, andernfalls false.

offset

()

Methode

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

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Ändert die Position des Rectangle-Objekts ausgehend von seiner oberen linken Ecke um die angegebenen Beträge.

Parameter

	`dx:Number` — Verschiebt den Wert x des Rectangle-Objekts um diesen Wert.

	`dy:Number` — Verschiebt den Wert y des Rectangle-Objekts um diesen Wert.

Siehe auch

Verwenden von Rectangle-Objekten

offsetPoint

()

Methode

public function offsetPoint(point:Point):void

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Ändert die Position des Rectangle-Objekts, wobei ein Point-Objekt als Parameter dient. Diese Methode entspricht der Methode Rectangle.offset(), das Point-Objekt wird jedoch als Parameter angenommen.

Parameter

point:Point — Ein Point-Objekt, mit dem dieses Rectangle-Objekt versetzt werden kann.

Siehe auch

flash.geom.Point
Verwenden von Rectangle-Objekten

setEmpty

()

Methode

public function setEmpty():void

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Setzt alle Eigenschaften des Rectangle-Objekts auf 0. Ein Rectangle-Objekt ist leer, wenn seine Breite oder Höhe kleiner oder gleich 0 ist.

Diese Methode setzt die Werte der Eigenschaften x, y, width und height auf 0.

Siehe auch

x
y
width
height

toString

()

Methode

public function toString():String

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Erstellt und übergibt einen String, der die horizontalen und vertikalen Positionen sowie die Breite und Höhe des Rectangle-Objekts enthält.

Rückgabewerte

String — Ein String, der die Werte der folgenden Eigenschaften des Rectangle-Objekts angibt: x, y, width und height.

Siehe auch

x
y
width
height

union

()

Methode

public function union(toUnion:Rectangle):Rectangle

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

Vereinigt zwei Rechtecke miteinander, indem der vertikale und horizontale Bereich zwischen ihnen gefüllt wird, so dass ein neues Rectangle-Objekt entsteht.

Parameter

toUnion:Rectangle — Ein Rectangle-Objekt, das diesem Rectangle-Objekt hinzugefügt wird.

Rückgabewerte

Rectangle — Ein neues Rectangle-Objekt aus der Vereinigung der beiden Rechtecke.

Siehe auch

Verwenden von Rectangle-Objekten

Beispiele Verwendung von Beispielen

RectangleExample.as

Im folgenden Beispiel werden mithilfe der RectangleExample-Klasse drei neue Rectangle-Objekte an verschiedenen x,y-Koordinaten mit unterschiedlichen Höhen und Breiten erstellt. Anschließend wird die erfolgreiche Erstellung der Rectangle-Instanzen mithilfe der trace()-Methode bestätigt. Dann wird die boolesche Variable isContained dem Ergebnis zugeordnet, das sich aus dem Aufruf der containsRect()-Methode ergibt. Damit wird festgelegt, dass das dritte Rechteck nicht vollständig vom zweiten Rechteck eingeschlossen wird.

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

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/geom/Rectangle.html

Komponenten-Referenzhandbuch für ActionScript 3.0		Alle Pakete \| Alle Klassen \| Sprachelemente \| Stichwortverzeichnis \| Anhänge \| Konventionen \| Frames Keine Frames
Rectangle	Eigenschaften \| Methoden \| Beispiele

Paket	flash.geom
Klasse	public class Rectangle
Vererbung	Rectangle Object