| Package | flash.geom |
| Classe | public class Rectangle |
| Héritage | Rectangle Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Les propriétés x, y, width et height de la classe Rectangle sont indépendantes les unes des autres. Le fait de modifier l'une de ces propriétés n'a aucun effet sur les autres. Les propriétés right et bottom, en revanche, sont intégralement liées à ces quatre propriétés. La modification de la valeur des propriétés right et bottom, par exemple, a une incidence sur la valeur des propriétés width et height, respectivement.
Les méthodes et propriétés suivantes utilisent les objets Rectangle :
applyFilter(), colorTransform(), copyChannel(), copyPixels(), draw(), fillRect(), generateFilterRect(), getColorBoundsRect(), getPixels(), merge(), paletteMap(), pixelDisolve(), setPixels() et threshold() et la propriété rect de la classe BitmapData
getBounds() et getRect(), ainsi que les propriétés scrollRect et scale9Grid de la classe DisplayObject ;
getCharBoundaries() de la classe TextField ;
pixelBounds de la classe Transform ;
bounds de la méthode startDrag() de la classe Sprite ;
printArea de la méthode addPage() de la classe PrintJob.
Vous pouvez utiliser le constructeur new Rectangle() pour créer un objet Rectangle.
Remarque : la classe Rectangle ne définit pas un objet d'affichage Shape rectangulaire. Pour dessiner un objet Shape rectangulaire à l'écran, utilisez la méthode drawRect() de la classe Graphics.
Voir aussi
| Propriété | Défini par | ||
|---|---|---|---|
| bottom : Number Somme des propriétés y et height. | Rectangle | ||
| bottomRight : Point Emplacement du coin inférieur droit de l'objet Rectangle, déterminé par les valeurs des propriétés right et bottom. | Rectangle | ||
![]() | constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet. | Object | |
| height : Number Hauteur du rectangle en pixels. | Rectangle | ||
| left : Number Coordonnée x du coin supérieur gauche du rectangle. | Rectangle | ||
![]() | prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction. | Object | |
| right : Number Somme des propriétés x et width. | Rectangle | ||
| size : Point Taille de l'objet Rectangle, exprimée en tant qu'objet Point avec les valeurs des propriétés width et height. | Rectangle | ||
| top : Number Coordonnée y du coin supérieur gauche du rectangle. | Rectangle | ||
| topLeft : Point Emplacement du coin supérieur gauche de l'objet Rectangle, déterminé par les coordonnées x et y du point. | Rectangle | ||
| width : Number Largeur du rectangle en pixels. | Rectangle | ||
| x : Number Coordonnée x du coin supérieur gauche du rectangle. | Rectangle | ||
| y : Number Coordonnée y du coin supérieur gauche du rectangle. | Rectangle | ||
| Méthode | Défini par | ||
|---|---|---|---|
Crée un objet Rectangle dont le coin supérieur gauche est déterminé par les paramètres x et y, avec des paramètres width et height spécifiés. | Rectangle | ||
Renvoie un nouvel objet Rectangle avec les mêmes valeurs que l'objet Rectangle d'origine pour les propriétés x, y, width (largeur) et height (hauteur). | Rectangle | ||
Détermine si le point spécifié figure dans la zone rectangulaire définie par cet objet Rectangle. | Rectangle | ||
Détermine si le point spécifié figure dans la zone rectangulaire définie par cet objet Rectangle. | Rectangle | ||
Détermine si l'objet Rectangle spécifié par le paramètre rect figure dans cet objet Rectangle. | Rectangle | ||
Détermine si l'objet spécifié dans le paramètre toCompare est égal à cet objet Rectangle. | Rectangle | ||
![]() | Indique si la propriété spécifiée d'un objet est définie. | Object | |
Agrandit l'objet Rectangle en fonction des quantités spécifiées en pixels. | Rectangle | ||
Agrandit la taille de l'objet Rectangle. | Rectangle | ||
Si l'objet Rectangle spécifié dans le paramètre toIntersect forme une intersection avec cet objet Rectangle, la zone d'intersection est renvoyée en tant qu'objet Rectangle. | Rectangle | ||
Détermine si l'objet spécifié par le paramètre toIntersect forme une intersection avec cet objet Rectangle. | Rectangle | ||
Détermine si cet objet Rectangle est vide. | Rectangle | ||
![]() | Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l'objet spécifié en tant que paramètre. | Object | |
Règle la position de l'objet Rectangle, identifié par son coin supérieur gauche, en fonction des quantités spécifiées. | Rectangle | ||
Règle l'emplacement de l'objet Rectangle en utilisant un objet Point comme paramètre. | Rectangle | ||
![]() | Indique si la propriété spécifiée existe et est énumérable. | Object | |
Définit toutes les propriétés de l'objet Rectangle sur 0. | Rectangle | ||
![]() | Définit la disponibilité d'une propriété dynamique pour les opérations en boucle. | Object | |
Crée et renvoie une chaîne qui répertorie les positions horizontale et verticale ainsi que la largeur et la hauteur de l'objet Rectangle. | Rectangle | ||
Additionne deux rectangles pour créer un nouvel objet Rectangle en remplissant l'essentiel de l'espace horizontal et vertical qui les sépare. | Rectangle | ||
![]() | Renvoie la valeur primitive de l'objet spécifié. | Object | |
| bottom | propriété |
bottom:Number [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Somme des propriétés y et height.
public function get bottom():Number public function set bottom(value:Number):voidVoir aussi
| bottomRight | propriété |
bottomRight:Point [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Emplacement du coin inférieur droit de l'objet Rectangle, déterminé par les valeurs des propriétés right et bottom.
public function get bottomRight():Point public function set bottomRight(value:Point):voidVoir aussi
| height | propriété |
public var height:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Hauteur du rectangle en pixels. La modification de la valeur height d'un objet Rectangle n'a pas d'effet sur les propriétés x, y et width.
Voir aussi
| left | propriété |
left:Number [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Coordonnée x du coin supérieur gauche du rectangle. La modification de la propriété left d'un objet Rectangle n'a pas d'effet sur les propriétés y et height. Elle a toutefois une incidence sur la propriété width, alors que la modification de la valeur x n'a aucun effet sur la propriété width.
La valeur de la propriété left est égale à la valeur de la propriété x.
public function get left():Number public function set left(value:Number):voidVoir aussi
| right | propriété |
right:Number [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Somme des propriétés x et width.
public function get right():Number public function set right(value:Number):voidVoir aussi
| size | propriété |
size:Point [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Taille de l'objet Rectangle, exprimée en tant qu'objet Point avec les valeurs des propriétés width et height.
public function get size():Point public function set size(value:Point):voidVoir aussi
| top | propriété |
top:Number [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Coordonnée y du coin supérieur gauche du rectangle. La modification de la propriété top d'un objet Rectangle n'a pas d'effet sur les propriétés x et width. Elle a toutefois une incidence sur la propriété height, alors que la modification de la valeur y n'a aucun effet sur la propriété height.
La valeur de la propriété top est égale à la valeur de la propriété y.
public function get top():Number public function set top(value:Number):voidVoir aussi
| topLeft | propriété |
topLeft:Point [lecture-écriture] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Emplacement du coin supérieur gauche de l'objet Rectangle, déterminé par les coordonnées x et y du point.
public function get topLeft():Point public function set topLeft(value:Point):voidVoir aussi
| width | propriété |
public var width:Number| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Largeur du rectangle, en pixels. La modification de la valeur width d'un objet Rectangle n'a pas d'effet sur les propriétés x, y et height.
Voir aussi
| x | propriété |
public var x:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Coordonnée x du coin supérieur gauche du rectangle. La modification de la valeur de la propriété x d'un objet Rectangle n'a pas d'effet sur les propriétés y, width et height.
La valeur de la propriété x est égale à la valeur de la propriété left.
Voir aussi
| y | propriété |
public var y:Number| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Coordonnée y du coin supérieur gauche du rectangle. La modification de la valeur de la propriété y d'un objet Rectangle n'a pas d'effet sur les propriétés x, width et height.
La valeur de la propriété y est égale à la valeur de la propriété top.
Voir aussi
| Rectangle | () | Constructeur |
public function Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Crée un objet Rectangle dont le coin supérieur gauche est déterminé par les paramètres x et y, et dont la hauteur et la largeur sont spécifiées par les paramètres width et height. Si vous appelez cette fonction sans paramètres, les propriétés x, y, width et height du rectangle créé seront définies sur 0.
x:Number (default = 0) —
Coordonnée x du coin supérieur gauche du rectangle.
| |
y:Number (default = 0) —
Coordonnée y du coin supérieur gauche du rectangle.
| |
width:Number (default = 0) — Largeur du rectangle en pixels. | |
height:Number (default = 0) — Hauteur du rectangle en pixels. |
Voir aussi
| clone | () | méthode |
public function clone():Rectangle| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Renvoie un nouvel objet Rectangle avec les mêmes valeurs que l'objet Rectangle d'origine pour les propriétés x, y, width et height.
Rectangle —
Nouvel objet Rectangle avec les mêmes valeurs que l'objet Rectangle d'origine pour les propriétés x, y, width et height.
|
Voir aussi
| contains | () | méthode |
public function contains(x:Number, y:Number):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Détermine si le point spécifié figure dans la zone rectangulaire définie par cet objet Rectangle.
Paramètres
x:Number —
Coordonnée x (position horizontale) du point.
| |
y:Number —
Coordonnée y (position verticale) du point.
|
Boolean —
Si le point spécifié figure dans l'objet Rectangle, true est renvoyé ; false dans le cas contraire.
|
Voir aussi
| containsPoint | () | méthode |
public function containsPoint(point:Point):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Détermine si le point spécifié figure dans la zone rectangulaire définie par cet objet Rectangle. Cette méthode est similaire à la méthode Rectangle.contains(), à ceci près qu'elle prend un objet Point comme paramètre.
Paramètres
point:Point —
Le point, tel qu'il est représenté par ses coordonnées x et y.
|
Boolean —
Si le point spécifié figure dans l'objet Rectangle, true est renvoyé ; false dans le cas contraire.
|
Voir aussi
| containsRect | () | méthode |
public function containsRect(rect:Rectangle):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Détermine si l'objet Rectangle spécifié par le paramètre rect figure dans cet objet Rectangle. On dit qu'un objet Rectangle en contient un autre si ce dernier est entièrement circonscrit dans les limites du premier.
Paramètres
rect:Rectangle — Objet Rectangle en cours de vérification. |
Boolean —
Si l'objet Rectangle que vous spécifiez est compris dans cet objet Rectangle, true est renvoyé ; false dans le cas contraire.
|
| equals | () | méthode |
public function equals(toCompare:Rectangle):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Détermine si l'objet spécifié dans le paramètre toCompare est égal à cet objet Rectangle. Cette méthode compare les propriétés x, y, width et height d'un objet aux mêmes propriétés de cet objet Rectangle.
Paramètres
toCompare:Rectangle — Rectangle que vous voulez comparer à cet objet Rectangle. |
Boolean —
Si l'objet a exactement les mêmes valeurs que cet objet Rectangle en ce qui concerne les propriétés x, y, width et height, true est renvoyé ; false est renvoyé dans le cas contraire.
|
Voir aussi
| inflate | () | méthode |
public function inflate(dx:Number, dy:Number):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | Flash Player 9, Flash Player 9 |
Agrandit l'objet Rectangle en fonction des quantités spécifiées, en pixels. Le point central de l'objet Rectangle reste inchangé tandis que sa taille augmente de la valeur de dx sur la gauche et la droite, et de la valeur de dy vers le haut et bas.
Paramètres
dx:Number —
Valeur à ajouter sur la gauche et sur la droite de l'objet Rectangle. L'équation suivante permet de calculer la nouvelle largeur et la nouvelle position du rectangle :
x -= dx; width += 2 * dx; | |
dy:Number —
Valeur à ajouter en haut et en bas de l'objet Rectangle. L'équation suivante permet de calculer la nouvelle hauteur et la nouvelle position du rectangle :
y -= dy; height += 2 * dy; |
Voir aussi
| inflatePoint | () | méthode |
public function inflatePoint(point:Point):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Agrandit la taille de l'objet Rectangle. Cette méthode est similaire à la méthode Rectangle.inflate(), à ceci près qu'elle prend un objet Point comme paramètre.
Les deux exemples de code suivants donnent le même résultat :
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)
Paramètres
point:Point —
La propriété x de cet objet Point permet d'agrandir l'objet Rectangle horizontalement. Sa propriété y permet d'agrandir l'objet Rectangle verticalement.
|
Voir aussi
| intersection | () | méthode |
public function intersection(toIntersect:Rectangle):Rectangle| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Si l'objet Rectangle spécifié dans le paramètre toIntersect forme une intersection avec cet objet Rectangle, la zone d'intersection est renvoyée en tant qu'objet Rectangle. Si les rectangles ne se recoupent pas, cette méthode renvoie un objet Rectangle vide dont les propriétés sont définies sur 0.
Paramètres
toIntersect:Rectangle — Objet Rectangle à prendre comme comparaison pour voir s'il recoupe cet objet Rectangle. |
Rectangle —
Objet Rectangle qui correspond à la zone d'intersection. Si les rectangles ne se recoupent pas, cette méthode renvoie un objet Rectangle vide, c'est-à-dire un rectangle dont les propriétés x, y, width et height sont définies sur 0.
|
Voir aussi
| intersects | () | méthode |
public function intersects(toIntersect:Rectangle):Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Détermine si l'objet spécifié par le paramètre toIntersect forme une intersection avec cet objet Rectangle. Cette méthode vérifie les propriétés x, y, width et height de l'objet Rectangle spécifié pour déterminer s'il recoupe cet objet Rectangle.
Paramètres
toIntersect:Rectangle — Objet Rectangle à comparer à cet objet Rectangle. |
Boolean —
Si l'objet spécifié forme une intersection avec cet objet Rectangle, true est renvoyé ; false dans le cas contraire.
|
Voir aussi
| isEmpty | () | méthode |
public function isEmpty():Boolean| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Détermine si cet objet Rectangle est vide.
Valeur renvoyéeBoolean —
Si la largeur ou la hauteur de l'objet Rectangle est inférieure ou égale à 0, true est renvoyé ; false dans le cas contraire.
|
| offset | () | méthode |
public function offset(dx:Number, dy:Number):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Règle la position de l'objet Rectangle, identifié par son coin supérieur gauche, en fonction des quantités spécifiées.
Paramètres
dx:Number —
Déplace en fonction de cette quantité la valeur x de l'objet Rectangle.
| |
dy:Number —
Déplace en fonction de cette quantité la valeur y de l'objet Rectangle.
|
Voir aussi
| offsetPoint | () | méthode |
public function offsetPoint(point:Point):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Règle l'emplacement de l'objet Rectangle en utilisant un objet Point comme paramètre. Cette méthode est similaire à la méthode Rectangle.offset(), à ceci près qu'elle prend un objet Point comme paramètre.
Paramètres
point:Point — Objet Point à utiliser pour décaler cet objet Rectangle. |
Voir aussi
| setEmpty | () | méthode |
public function setEmpty():void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Définit toutes les propriétés de l'objet Rectangle sur 0. Un objet Rectangle est vide si sa largeur ou sa hauteur est inférieure ou égale à 0.
Cette méthode règle les valeurs des propriétés x, y, width et height sur 0.
Voir aussi
| toString | () | méthode |
public function toString():String| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Crée et renvoie une chaîne qui répertorie les positions horizontale et verticale ainsi que la largeur et la hauteur de l'objet Rectangle.
Valeur renvoyéeString —
Chaîne répertoriant la valeur de chacune des propriétés suivantes de l'objet Rectangle : x, y, width et height.
|
Voir aussi
| union | () | méthode |
public function union(toUnion:Rectangle):Rectangle| Version du langage: | ActionScript 3.0 |
| Versions du moteur d'exécution: | AIR 1.0 Flash Player 9 |
Additionne deux rectangles pour créer un nouvel objet Rectangle en remplissant l'essentiel de l'espace horizontal et vertical qui les sépare.
Paramètres
toUnion:Rectangle — Objet Rectangle à ajouter à cet objet Rectangle. |
Rectangle — Nouvel objet Rectangle qui correspond à l'union des deux rectangles. |
Voir aussi
trace() est utilisée pour confirmer la création réussie des occurrences de Rectangle. Une variable booléenne isContained est ensuite attribuée au résultat de l'appel à la méthode containsRect() qui détermine que le deuxième rectangle n'englobe pas complètement le troisième rectangle.
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
}
}
}