| Package | flash.geom |
| Classe | public class Rectangle |
| Héritage | Rectangle Object |
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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 BitmapDatagetBounds() 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
[static]
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 |
| Version du lecteur : | Flash Player 9 |
Somme des propriétés y et height.
public function get bottom():Number
public function set bottom(value:Number):void
Voir aussi
| bottomRight | propriété |
bottomRight:Point [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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):void
Voir aussi
| height | propriété |
public var height:Number
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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):void
Voir aussi
| right | propriété |
right:Number [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | Flash Player 9 |
Somme des propriétés x et width.
public function get right():Number
public function set right(value:Number):void
Voir aussi
| size | propriété |
size:Point [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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):void
Voir aussi
| top | propriété |
top:Number [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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):void
Voir aussi
| topLeft | propriété |
topLeft:Point [lecture-écriture]
| Version du langage : | ActionScript 3.0 |
| Version du lecteur : | 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):void
Voir aussi
| width | propriété |
public var width:Number
| Version du lecteur : | 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 |
| Version du lecteur : | 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
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 :
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)
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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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 |
| Version du lecteur : | 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
}
}
}
M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire
Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/geom/Rectangle.html