Packageflash.geom
Classepublic class Rectangle
HéritageRectangle Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Un objet Rectangle est une zone définie par sa position, indiquée par son angle supérieur gauche (x, y), ainsi que par sa largeur et sa hauteur.

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 :

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.

Consulter les exemples

Voir aussi

flash.display.DisplayObject.scrollRect
flash.display.BitmapData
flash.display.DisplayObject
flash.text.TextField.getCharBoundaries()
flash.geom.Transform.pixelBounds
flash.display.Sprite.startDrag()
flash.printing.PrintJob.addPage()
Utilisation d'objets Rectangle
Définition de la taille, de l'échelle et de l'orientation


Propriétés publiques
 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
 Inheritedconstructor : 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
 Inheritedprototype : 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éthodes publiques
 MéthodeDéfini par
  
Rectangle(x:Number = 0, y:Number = 0, width:Number = 0, height:Number = 0)
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
  
equals(toCompare:Rectangle):Boolean
Détermine si l’objet spécifié dans le paramètre toCompare est égal à cet objet Rectangle.
Rectangle
 Inherited
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
 Inherited
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
 Inherited
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
 Inherited
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
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
Détails des propriétés
bottomproprié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.


Implémentation
    public function get bottom():Number
    public function set bottom(value:Number):void

Voir aussi

bottomRightproprié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.


Implémentation
    public function get bottomRight():Point
    public function set bottomRight(value:Point):void

Voir aussi

heightproprié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

leftproprié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.


Implémentation
    public function get left():Number
    public function set left(value:Number):void

Voir aussi

rightproprié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.


Implémentation
    public function get right():Number
    public function set right(value:Number):void

Voir aussi

sizeproprié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.


Implémentation
    public function get size():Point
    public function set size(value:Point):void

Voir aussi

topproprié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.


Implémentation
    public function get top():Number
    public function set top(value:Number):void

Voir aussi

topLeftproprié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.


Implémentation
    public function get topLeft():Point
    public function set topLeft(value:Point):void

Voir aussi

widthproprié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

xproprié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

yproprié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

Détails du constructeur
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.

Paramètres
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

Détails des méthodes
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.

Valeur renvoyée
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.

Valeur renvoyée
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.

Valeur renvoyée
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.

Valeur renvoyée
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.

Valeur renvoyée
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.

Valeur renvoyée
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.

Valeur renvoyée
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ée
Boolean — 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ée
String — 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.

Valeur renvoyée
Rectangle — Nouvel objet Rectangle qui correspond à l'union des deux rectangles.

Voir aussi

Exemples Utilisation des exemples
RectangleExample.as

L'exemple suivant utilise la classe RectangleExample pour créer trois nouveaux objets Rectangle à diverses coordonnées x,y et selon différentes hauteurs et largeurs ; la méthode 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