| Package | flash.geom |
| Classe | public class Rectangle |
| Héritage | Rectangle  Object |
| Sous-classes | RoundedRectangle |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 :
- Les méthodes
applyFilter(),colorTransform(),copyChannel(),copyPixels(),draw(),fillRect(),generateFilterRect(),getColorBoundsRect(),getPixels(),merge(),paletteMap(),pixelDisolve(),setPixels()etthreshold()et la propriétérectde la classe BitmapData - les méthodes
getBounds()etgetRect(), ainsi que les propriétésscrollRectetscale9Gridde la classe DisplayObject ; - la méthode
getCharBoundaries()de la classe TextField ; - la propriété
pixelBoundsde la classe Transform ; - le paramètre
boundsde la méthodestartDrag()de la classe Sprite ; - le paramètre
printAreade la méthodeaddPage()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.
Plus d’exemples
Recherche d’unions et d’intersections d’objets Rectangle
Définition de la taille, de l’échelle et de l’orientation
Informations complémentaires
Eléments de l’API associés
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()
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| 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 | ||
| 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 | ||
Copie toutes les données de rectangle de l’objet Rectangle source dans l’objet Rectangle appelant. | 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 | |
Définit les membres du rectangle sur les valeurs spécifiées
| Rectangle | ||
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | 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é |
bottomRight | propriété |
bottomRight:Point| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Emplacement du coin inférieur droit de l’objet Rectangle, déterminé par les valeurs des propriétés right et bottom.
Implémentation
public function get bottomRight():Point public function set bottomRight(value:Point):voidEléments de l’API associés
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, Flash Lite 4 |
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.
Plus d’exemples
Eléments de l’API associés
left | propriété |
left:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implémentation
public function get left():Number public function set left(value:Number):voidPlus d’exemples
Eléments de l’API associés
right | propriété |
size | propriété |
size:Point| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Taille de l’objet Rectangle, exprimée en tant qu’objet Point avec les valeurs des propriétés width et height.
Implémentation
public function get size():Point public function set size(value:Point):voidEléments de l’API associés
top | propriété |
top:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Implémentation
public function get top():Number public function set top(value:Number):voidPlus d’exemples
Eléments de l’API associés
topLeft | propriété |
topLeft:Point| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Emplacement du coin supérieur gauche de l’objet Rectangle, déterminé par les coordonnées x et y du point.
Implémentation
public function get topLeft():Point public function set topLeft(value:Point):voidEléments de l’API associés
width | propriété |
public var width:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Plus d’exemples
Eléments de l’API associés
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, Flash Lite 4 |
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.
Plus d’exemples
Eléments de l’API associés
y | propriété |
public var y:Number| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
Plus d’exemples
Eléments de l’API associés
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, Flash Lite 4 |
Crée un objet Rectangle dont le coin supérieur gauche est déterminé par les paramètres x et y et présentant la hauteur et la largeur 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) | |
y:Number (default = 0) | |
width:Number (default = 0) | |
height:Number (default = 0) |
Eléments de l’API associés
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, Flash Lite 4 |
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.
|
Eléments de l’API associés
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, Flash Lite 4 |
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.
|
Eléments de l’API associés
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, Flash Lite 4 |
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.
|
Eléments de l’API associés
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, Flash Lite 4 |
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.
|
copyFrom | () | méthode |
public function copyFrom(sourceRect:Rectangle):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.0, Flash Lite 4 |
Copie toutes les données de rectangle de l’objet Rectangle source dans l’objet Rectangle appelant.
Paramètres
sourceRect:Rectangle — Objet Rectangle à partir duquel copier les données.
|
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, Flash Lite 4 |
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.
|
Eléments de l’API associés
inflate | () | méthode |
public function inflate(dx:Number, dy:Number):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0, Flash Player 9, Flash Player 9, Flash Lite 4 |
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;
|
Plus d’exemples
Eléments de l’API associés
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, Flash Lite 4 |
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.
|
Plus d’exemples
Eléments de l’API associés
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, Flash Lite 4 |
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.
|
Plus d’exemples
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, Flash Lite 4 |
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.
|
Plus d’exemples
Eléments de l’API associés
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, Flash Lite 4 |
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, Flash Lite 4 |
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.
|
Plus d’exemples
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, Flash Lite 4 |
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.
|
Plus d’exemples
Eléments de l’API associés
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, Flash Lite 4 |
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.
Eléments de l’API associés
setTo | () | méthode |
public function setTo(xa:Number, ya:Number, widtha:Number, heighta:Number):void| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | Flash Player 11, AIR 3.0, Flash Lite 4 |
Définit les membres du rectangle sur les valeurs spécifiées
Paramètres
xa:Number — Valeurs sur lesquelles définir le rectangle.
| |
ya:Number | |
widtha:Number | |
heighta:Number |
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, Flash Lite 4 |
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.
|
Eléments de l’API associés
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, Flash Lite 4 |
Additionne deux rectangles pour créer un nouvel objet Rectangle en remplissant l’essentiel de l’espace horizontal et vertical qui les sépare.
Remarque : la méthode union() ignore les rectangles dotés de la valeur 0 comme hauteur ou largeur, comme : var rect2:Rectangle = new Rectangle(300,300,50,0);
Paramètres
toUnion:Rectangle — Objet Rectangle à ajouter à cet objet Rectangle.
|
Rectangle — Nouvel objet Rectangle qui correspond à l’union des deux rectangles.
|
Plus d’exemples
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
}
}
}
Tue Jun 12 2018, 09:30 AM Z