IFlexDisplayObject  - AS3 Flex

Options d’accessibilité actuelles de l’objet d’affichage. Si vous modifiez la propriété accessibilityProperties ou l’un de ses champs dans accessibilityProperties, vous devez appeler la méthode Accessibility.updateProperties() pour appliquer vos modifications.

Remarque : pour tout objet créé dans l’environnement de création de Flash, la valeur de accessibilityProperties est préremplie avec les informations que vous avez entrées dans le panneau Accessibilité pour cet objet.

Indique la valeur de transparence alpha de l’objet spécifié. Les valeurs gérées sont comprises entre 0 (entièrement transparent) et 1 (entièrement opaque). La valeur par défaut est 1. Les objets d’affichage où alpha est défini sur 0 sont actifs, même s’ils sont invisibles.

Valeur de la classe BlendMode qui spécifie le mode de fondu à utiliser. Une image bitmap peut être dessinée en interne de deux manières. Si un mode de fondu ou un masque de découpage externe est activé, l’image bitmap est dessinée en ajoutant une forme carrée remplie avec l’image bitmap au rendu vectoriel. Si vous tentez de définir cette propriété sur une valeur non valide, les moteurs d’exécution de Flash la remplacent par BlendMode.NORMAL.

La propriété blendMode affecte chaque pixel de l’objet d’affichage. Chaque pixel est composé de trois couleurs élémentaires (rouge, vert et bleu), chacune de ces couleurs ayant une valeur située entre 0x00 et 0xFF. Flash Player ou Adobe AIR compare chaque couleur constituante d’un pixel dans le clip à la couleur correspondante du pixel d’arrière-plan. Par exemple si blendMode est défini sur BlendMode.LIGHTEN, Flash Player ou Adobe AIR compare la valeur rouge de l’objet d’affichage avec la valeur rouge de l’arrière-plan, et utilise la plus claire des deux comme valeur pour le composant rouge de la couleur affichée.

Le tableau suivant répertorie les réglages blendMode. La classe BlendMode définit les valeurs de chaîne que vous pouvez utiliser. Les illustrations du tableau ci-dessous présentent les valeurs blendMode appliquées à un objet d’affichage (2) circulaire superposé sur un autre objet d’affichage (1).

Constante BlendMode	Illustration	Description
BlendMode.NORMAL		L’objet d’affichage apparaît devant l’arrière-plan. Les valeurs de pixels de l’objet d’affichage écrasent celles de l’arrière-plan. Lorsque l’objet d’affichage est transparent, l’arrière-plan est visible.
BlendMode.LAYER		Impose la création d’un groupe de transparences pour l’objet d’affichage. Cela signifie que l’objet d’affichage est précomposé dans un tampon temporaire avant que son traitement ne se poursuive. Cette opération s’exécute automatiquement si l’objet d’affichage est préalablement placé en mémoire cache par le biais d’une mise en cache des bitmaps ou s’il correspond à un conteneur d’objet d’affichage qui possède au moins un objet enfant associé à un réglage blendMode autre que BlendMode.NORMAL. Pas de prise en charge sous le rendu sur GPU.
BlendMode.MULTIPLY		Multiplie les valeurs des couleurs élémentaires de l’objet d’affichage par celles de la couleur d’arrière-plan, puis les normalise en les divisant par 0xFF, ce qui donne des couleurs plus sombres. Ce réglage est souvent utilisé pour les effets d’ombre et de profondeur. Par exemple, si une couleur élémentaire (comme le rouge) d’un pixel de l’objet d’affichage et la couleur correspondante du pixel de l’arrière-plan ont toutes les deux une valeur de 0x88, le résultat de la multiplication est 0x4840. La division par 0xFF donne une valeur de 0x48 pour cette couleur élémentaire, qui est plus sombre que celle de l’objet d’affichage ou de l’arrière-plan.
BlendMode.SCREEN		Multiplie le complément (l’inverse) de la couleur de l’objet d’affichage par le complément de la couleur d’arrière-plan, ce qui donne un effet de blanchissement. Ce réglage est couramment utilisé pour la mise en valeur ou pour supprimer les parties noires de l’objet d’affichage.
BlendMode.LIGHTEN		Sélectionne les plus claires des couleurs élémentaires de l’objet d’affichage et la couleur d’arrière-plan (celles qui ont les valeurs les plus élevées). Ce réglage est généralement utilisé pour les superpositions. Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xFFCC33, et que le pixel d’arrière-plan possède une valeur RVB réglée sur 0xDDF800, la valeur RVB obtenue pour le pixel affiché est 0xFFF833 (car 0xFF > 0xDD, 0xCC < 0xF8 et 0x33 > 0x00 = 33). Pas de prise en charge sous le rendu sur GPU.
BlendMode.DARKEN		Sélectionne les plus sombres des couleurs élémentaires de l’objet d’affichage et de l’arrière-plan (celles qui ont les valeurs les plus faibles). Ce réglage est généralement utilisé pour les superpositions. Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xFFCC33, et que le pixel d’arrière-plan possède une valeur RVB réglée sur 0xDDF800, la valeur RVB obtenue pour le pixel affiché est 0xDDCC00 (car 0xFF > 0xDD, 0xCC < 0xF8 et 0x33 > 0x00 = 33). Pas de prise en charge sous le rendu sur GPU.
BlendMode.DIFFERENCE		Compare les couleurs élémentaires de l’objet d’affichage à celles de son arrière-plan et soustrait la valeur la plus sombre des deux couleurs élémentaires de la plus claire. Ce réglage est habituellement utilisé pour obtenir des couleurs plus vibrantes. Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xFFCC33, et le pixel d’arrière-plan possède une valeur RVB réglée sur 0xDDF800, la valeur RVB résultante du pixel affiché est 0x222C33 (parce que 0xFF - 0xDD = 0x22, 0xF8 - 0xCC = 0x2C et 0x33 - 0x00 = 0x33).
BlendMode.ADD		Ajoute les valeurs des couleurs élémentaires de l’objet d’affichage à celles de son arrière-plan, en appliquant un plafond de 0xFF. Ce réglage est habituellement utilisé pour animer un fondu d’éclaircissement entre deux objets. Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xAAA633, et que le pixel d’arrière-plan possède une valeur RVB réglée sur 0xDD2200, la valeur RVB résultante du pixel affiché est 0xFFC833 (parce que 0xAA + 0xDD > 0xFF, 0xA6 + 0x22 = 0xC8 et 0x33 + 0x00 = 0x33).
BlendMode.SUBTRACT		Soustrait les valeurs des couleurs élémentaires de l’objet d’affichage de celles de la couleur d’arrière-plan, en appliquant un plancher de 0. Ce réglage est habituellement utilisé pour animer un fondu de plus en plus sombre entre deux objets. Par exemple, si l’objet d’affichage possède un pixel dont la valeur RVB est 0xAA2233, et que le pixel d’arrière-plan a une valeur RVB réglée sur 0xDDA600, alors la valeur RVB obtenue pour le pixel affiché est 0x338400 (car 0xDD - 0xAA = 0x33, 0xA6 - 0x22 = 0x84 et 0x00 - 0x33 < 0x00).
BlendMode.INVERT		Inverse l’arrière-plan.
BlendMode.ALPHA		Applique la valeur alpha de chaque pixel de l’objet d’affichage à l’arrière-plan. Pour ce faire, le réglage blendMode de l’objet d’affichage parent doit être réglé sur BlendMode.LAYER. Par exemple, dans l’illustration, l’objet d’affichage parent, qui est un arrière-plan blanc, a un paramètre blendMode = BlendMode.LAYER. Pas de prise en charge sous le rendu sur GPU.
BlendMode.ERASE		Efface l’arrière-plan sur la base de la valeur alpha de l’objet d’affichage. Pour ce faire, le réglage blendMode de l’objet d’affichage parent doit être défini sur BlendMode.LAYER. Par exemple, dans l’illustration, l’objet d’affichage parent, qui est un arrière-plan blanc, a un paramètre blendMode = BlendMode.LAYER. Pas de prise en charge sous le rendu sur GPU.
BlendMode.OVERLAY		Ajuste la couleur de chaque pixel sur la base de l’obscurité de l’arrière-plan. Si l’arrière-plan est plus clair qu’un gris à 50 %, les couleurs de l’objet d’affichage et de l’arrière-plan sont masquées, ce qui donne une couleur plus claire. Si l’arrière-plan est plus foncé qu’un gris à 50 %, les couleurs sont multipliées, ce qui donne une couleur plus sombre. Ce réglage est habituellement utilisé pour les effets d’ombrage. Pas de prise en charge sous le rendu sur GPU.
BlendMode.HARDLIGHT		Ajuste la couleur de chaque pixel sur la base de l’obscurité de l’objet d’affichage. Si l’objet d’affichage est plus clair qu’un gris à 50 %, les couleurs de l’objet d’affichage et de l’arrière-plan sont masquées, ce qui permet d’obtenir une couleur plus claire. Si l’objet d’affichage est plus foncé qu’un gris à 50 %, les couleurs sont multipliées, ce qui donne une couleur plus sombre. Ce réglage est habituellement utilisé pour les effets d’ombrage. Pas de prise en charge sous le rendu sur GPU.
BlendMode.SHADER	S/O	Ajuste la couleur à l’aide d’une routine de shader personnalisée. Le shader utilisé est spécifié en tant qu’occurrence Shader affectée à la propriété blendShader. La définition de la propriété blendShader d’un objet d’affichage sur une occurrence Shader définit automatiquement la propriété blendMode de l’objet d’affichage sur BlendMode.SHADER. Si la propriété blendMode est définie sur BlendMode.SHADER sans que la propriété blendShader n’ait été définie auparavant, la propriété blendMode est définie sur BlendMode.NORMAL. Pas de prise en charge sous le rendu sur GPU.

Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage. Cette mise en cache permet d’améliorer les performances des objets d’affichage qui intègrent du contenu vectoriel complexe.

Toutes les données vectorielles d’un objet d’affichage contenant une image bitmap en mémoire cache sont tracées sur l’image bitmap et non pas sur l’affichage principal. Si la propriété cacheAsBitmapMatrix est définie sur null ou n’est pas prise en charge, l’image bitmap est alors copiée sur l’affichage principal sous forme de pixels non étirés et non pivotés accrochés aux limites de pixels les plus proches. Les correspondances des pixels avec l’objet parent se font selon un rapport de 1 à 1. Si les limites de l’image bitmap changent, elle est recréée au lieu d’être étirée.

Si la propriété cacheAsBitmapMatrix n’est pas nulle et est prise en charge, l’objet est dessiné sur l’image bitmap hors écran à l’aide de cette matrice, et les résultats d’étirement et/ou de rotation de ce rendu sont utilisés pour dessiner l’objet sur l’affichage principal.

Aucune bitmap interne n’est créée sauf si la propriété cacheAsBitmap est définie sur true.

Après avoir défini la propriété cacheAsBitmap du bouton sur true, le rendu ne change pas, bien que l’objet d’affichage procède automatiquement à l’accrochage aux pixels. La vitesse d’animation peut être beaucoup plus importante selon la complexité du contenu vectoriel.

La propriété cacheAsBitmap est définie automatiquement sur true lorsque vous appliquez un filtre à l’objet d’affichage (lorsque son tableau filter n’est pas vide). Lorsqu’un objet d’affichage est filtré, cacheAsBitmap renvoie la valeur true pour cet objet d’affichage, même si vous l’aviez définie sur false. Si vous supprimez tous les filtres d’un objet d’affichage, le réglage cacheAsBitmap à sa position précédente.

Un objet d’affichage n’utilise pas d’image bitmap, même si la propriété cacheAsBitmap est définie sur true et procède au rendu à partir de données vectorielles dans les cas suivants :

• L’image bitmap est trop grande : dans AIR 1.5 et Flash Player 10, la taille maximale d’une image bitmap est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image bitmap est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Dans Flash Player 9 et versions antérieures, la limite est de 2 880 pixels de haut sur 2 880 pixels de large.
• L’image bitmap ne peut être allouée en mémoire (erreur liée à une saturation de la mémoire).

La propriété cacheAsBitmap est utilisée de préférence avec les clips dont le contenu est principalement statique et qui n’est ni redimensionné, ni pivoté de façon fréquente. Avec ce type de clip, cacheAsBitmap permet d’améliorer les performances lors de la conversion (lorsque les positions x et y sont changées).

Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. Le package flash.filters contient plusieurs classes qui définissent des filtres spécifiques.

Ces filtres peuvent s’appliquer dans Flash Professional pendant la phase de conception ou d’exécution à l’aide du code ActionScript. Pour appliquer un filtre avec ActionScript, vous devez créer une copie temporaire de l’intégralité du tableau filters, modifier le tableau temporaire, puis reporter les valeurs de ce tableau temporaire dans le tableau filters. Vous ne pouvez pas ajouter directement un nouvel objet filtre au tableau filters.

Pour ajouter un filtre à l’aide du code ActionScript, exécutez les opérations suivantes (supposons que l’objet d’affichage cible est appelé myDisplayObject) :

1. Créez un objet filtre avec la méthode constructeur de la classe de filtre choisie.
2. Assignez la valeur du tableau myDisplayObject.filters à un tableau temporaire, tel que celui qui est nommé myFilters.
3. Ajoutez le nouvel objet filtre au tableau temporaire, myFilters.
4. Affectez la valeur du tableau temporaire au tableau myDisplayObject.filters.

Si le tableau filters n’est pas défini, il n’est pas nécessaire d’utiliser un tableau temporaire. Par contre, vous pouvez affecter directement un littéral de tableau contenant un ou plusieurs des objets filtre que vous avez créés. Le premier exemple de la section Exemples ajoute un filtre d’ombre portée à l’aide du code qui traite à la fois les tableaux de filters définis et non définis.

Pour modifier un objet filtre, vous devez utiliser la technique de modification d’une copie du tableau filters :

1. Assignez la valeur du tableau filters à un tableau temporaire, tel que celui qui est nommé myFilters.
2. Modifiez la propriété avec le tableau temporaire, myFilters. Par exemple, pour définir la propriété quality du premier filtre du tableau, utilisez le code suivant : myFilters[0].quality = 1;
3. Affectez la valeur du tableau temporaire au tableau filters.

Lors du chargement, si un objet d’affichage est associé à un filtre, ce bouton se place en mémoire cache en tant qu’image bitmap transparente. A partir de ce stade, tant que le clip possède une liste de filtres valide, le lecteur place le clip en mémoire cache au format bitmap. Cette image bitmap source est ensuite reprise en tant qu’image source pour les effets de filtrage. Tout objet d’affichage comporte généralement deux bitmaps : le premier avec l’objet d’affichage source non filtré d’origine et un autre pour l’image finale après filtrage. L’image finale est utilisée pour le rendu. Tant que l’objet d’affichage ne change pas, l’image source ne nécessite aucune mise à jour.

Le package flash.filters contient des classes de filtres. Par exemple, pour créer un filtre DropShadow, vous devez écrire le code suivant :

     import flash.filters.DropShadowFilter
     var myFilter:DropShadowFilter = new DropShadowFilter (distance, angle, color, alpha, blurX, blurY, quality, inner, knockout)
     

Vous pouvez utiliser l’opérateur is pour déterminer le type de filtre affecté à chaque position d’index dans le tableau filter. Par exemple, le code suivant indique comment déterminer la position du premier filtre dans le tableau filters qui est DropShadowFilter :

     import flash.text.TextField;
     import flash.filters.*;
     var tf:TextField = new TextField();
     var filter1:DropShadowFilter = new DropShadowFilter();
     var filter2:GradientGlowFilter = new GradientGlowFilter();
     tf.filters = [filter1, filter2];
     
     tf.text = "DropShadow index: " + filterPosition(tf, DropShadowFilter).toString(); // 0
     addChild(tf)
     
     function filterPosition(displayObject:DisplayObject, filterClass:Class):int {
         for (var i:uint = 0; i < displayObject.filters.length; i++) {
             if (displayObject.filters[i] is filterClass) {
                 return i;
             }
         }
         return -1;
     }
     

Remarque : comme vous ne pouvez pas appliquer directement un nouvel objet filtre au tableau DisplayObject.filters, le code suivant n’a pas d’effet sur l’objet d’affichage cible, appelé myDisplayObject :

     myDisplayObject.filters.push(myDropShadow);
     

Indique la hauteur de l’objet d’affichage, en pixels. La hauteur est calculée en fonction des limites du contenu de l’objet d’affichage. Lorsque vous définissez la propriété height, la propriété scaleY est ajustée en conséquence, comme illustré dans le code suivant :

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleY) // 1;
    rect.height = 200;
    trace(rect.scaleY) // 2;

A l’exception des objets TextField et Video, un objet d’affichage sans contenu (comme un sprite vide) a une hauteur de 0, même si vous essayez de définir height sur une valeur différente.

Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. La propriété loaderInfo est définie uniquement pour l’objet d’affichage racine d’un fichier SWF ou d’une image bitmap chargée (et non pas d’une image bitmap dessinée avec le code ActionScript). Pour trouver l’objet loaderInfo associé avec le fichier SWF qui contient un objet d’affichage myDisplayObject, utilisez myDisplayObject.root.loaderInfo.

Un grand fichier SWF peut superviser son téléchargement en appelant this.root.loaderInfo.addEventListener(Event.COMPLETE, func).

L’objet d’affichage appelant est masqué par l’objet mask spécifié. Afin de vous assurer que le masquage fonctionne lorsque la scène est redimensionnée, l’objet d’affichage mask doit figurer dans la section active de la liste d’affichage. L’objet mask en tant que tel n’est pas dessiné. Réglez mask sur null pour supprimer le masque.

Pour pouvoir redimensionner un objet masque, il doit figurer dans la liste d’affichage. Pour faire glisser un objet Sprite de masque (à l’aide de sa méthode startDrag()), vous devez placer ce dernier dans la liste d’affichage. Pour appeler la méthode startDrag() d’un sprite de masque en fonction d’un événement mouseDown en cours de distribution par le sprite, définissez la propriété buttonMode du sprite sur true.

Lorsque les objets d’affichage sont mis en cache en définissant la propriété cacheAsBitmap sur true et la propriété cacheAsBitmapMatrix sur un objet Matrix, le masque et l’objet d’affichage en cours de masquage doivent appartenir à la même image bitmap en mémoire cache. Par conséquent, si l’objet d’affichage est mis en cache, le masque doit être un enfant de l’objet d’affichage. Si un ancêtre de l’objet d’affichage sur la liste d’affichage est mis en cache, le masque doit être un enfant de cet ancêtre ou de l’un de ses descendants. Si plusieurs ancêtres de l’objet masqué sont mis en cache, le masque doit être un descendant du conteneur mis en cache le plus proche de l’objet masqué dans la liste d’affichage.

Remarque : un seul objet mask ne peut être utilisé pour masquer plusieurs objets d’affichage appelants. Lorsque mask est affecté à un deuxième objet d’affichage, il est supprimé du masque du premier objet et la propriété mask de cet objet devient null.

Hauteur mesurée de l’objet.

Cette valeur est généralement codée en dur pour les habillages graphiques, car ce nombre correspond tout simplement au nombre de pixels du graphique. Pour les habillages de code, la valeur peut également être codée en dur si vous souhaitez que l’objet soit tracé à une taille bien définie. Si la taille peut changer en fonction de différentes propriétés, vous pouvez également utiliser une interface ILayoutManagerClient, de sorte qu’une méthode measure() soit appelée au moment opportun. Vous pouvez ainsi calculer la hauteur measuredHeight.

Largeur mesurée de l’objet.

Cette valeur est généralement codée en dur pour les habillages graphiques, car ce nombre correspond tout simplement au nombre de pixels du graphique. Pour les habillages de code, la valeur peut également être codée en dur si vous souhaitez que l’objet soit tracé à une taille bien définie. Si la taille peut changer en fonction de différentes propriétés, vous pouvez également utiliser une interface ILayoutManagerClient, de sorte qu’une méthode measure() soit appelée au moment opportun. Vous pouvez ainsi calculer la hauteur measuredHeight.

Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels.

Remarque : si vous avez fait pivoter un objet DisplayObject, la coordonnée x renvoyée reflète l’objet non pivoté.

Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels.

Remarque : si vous avez fait pivoter un objet DisplayObject, la coordonnée y renvoyée reflète l’objet non pivoté.

Indique le nom d’occurrence de DisplayObject. L’objet peut être identifié dans la liste d’enfants de son conteneur d’objet d’affichage parent en appelant la méthode getChildByName() du conteneur de l’objet d’affichage.

Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. Une image bitmap transparente contient des données de canal alpha et est dessinée de façon transparente. Une image bitmap opaque ne comporte pas de canal alpha (et procède au rendu plus rapidement qu’avec une image bitmap transparente). Si l’image bitmap est opaque, vous spécifiez la couleur d’arrière-plan à utiliser.

Si elle est réglée sur une valeur numérique, la surface est opaque (et non transparente) et la couleur d’arrière-plan RVB correspond au nombre spécifié. Si défini sur null (la valeur par défaut), l’objet d’affichage a un arrière-plan transparent.

La propriété opaqueBackground est conçue principalement pour l’utilisation avec la propriété cacheAsBitmap, pour l’optimisation du rendu. Pour les objets d’affichage dont la propriété cacheAsBitmap est définie sur true, le paramètre opaqueBackground peut améliorer les performances de rendu.

La zone opaque d’arrière-plan n’est pas prise comme référence lors de l’appel de la méthode hitTestPoint() avec le paramètre shapeFlag défini sur true.

La zone d’arrière-plan opaque ne réagit pas aux événements de souris.

Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage. Appliquez la propriété parent pour spécifier un chemin relatif vers les objets d’affichage qui figurent au-dessus de l’objet d’affichage actuel dans la hiérarchie de liste d’affichage.

Vous pouvez utiliser parent pour remonter de plusieurs niveaux dans l’arborescence de la liste d’affichage, comme dans l’exemple suivant :

     this.parent.parent.alpha = 20;
     

Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier. Pour un objet Bitmap représentant un fichier d’image chargé, la propriété root correspond à l’objet Bitmap lui-même. Pour l’occurrence de la classe principale du premier fichier SWF chargé, la propriété root correspond à l’objet d’affichage lui-même. La propriété root de l’objet Stage correspond à l’objet Stage en tant que tel. La propriété root est définie sur null pour tout objet d’affichage qui n’a pas été ajouté à la liste d’affichage, sauf s’il a été ajouté à un conteneur d’objet d’affichage qui ne rentre pas dans le cadre de la liste d’affichage, mais qui est un enfant de l’objet d’affichage de plus haut niveau dans un fichier SWF chargé.

Par exemple, si vous créez un nouvel objet Sprite en appelant la méthode de constructeur Sprite(), sa propriété root reste null jusqu’à ce qu’elle soit ajoutée à la liste d’affichage (ou pour un conteneur d’objet d’affichage qui ne rentre pas dans le cadre de la liste d’affichage, mais qui est un enfant de l’objet d’affichage de plus haut niveau dans un fichier SWF chargé).

Pour un fichier SWF chargé, même si l’objet Loader utilisé pour charger le fichier ne figure pas dans la liste d’affichage, l’objet d’affichage de plus haut niveau du fichier SWF voit sa propriété root définie sur lui-même. La propriété root de l’objet Loader n’est pas définie tant qu’elle n’est pas ajoutée en tant qu’enfant de l’objet d’affichage pour lequel la propriété root est définie.

Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. Les valeurs comprises entre 0 et 180 représentent la rotation en sens horaire ; les valeurs comprises entre 0 et -180 représentent la rotation en sens anti-horaire. Les valeurs hors de cette plage sont ajoutées ou soustraites de 360 pour obtenir une valeur comprise dans la plage. Par exemple, l’instruction my_video.rotation = 450 correspond à my_video.rotation = 90.

Grille de mise à l’échelle en vigueur. Si la valeur est définie sur null, tout l’objet d’affichage est alors dimensionné normalement lorsqu’une transformation par redimensionnement est appliquée.

Lorsque vous définissez une propriété scale9Grid, l’objet d’affichage est divisé dans une grille comportant neuf zones, en fonction du rectangle scale9Grid, qui définit le centre de la grille. La grille est constituée des huit autres zones suivantes :

• le coin supérieur gauche, en dehors du rectangle,
• la zone située au-dessus du rectangle,
• le coin supérieur droit, en dehors du rectangle,
• la zone située à gauche du rectangle,
• la zone située à droite du rectangle,
• le coin inférieur gauche, en dehors du rectangle,
• la zone située au-dessous du rectangle,
• le coin inférieur droit, en dehors du rectangle.

Les huit zones entourant la partie centrale (définie par le rectangle) peuvent être conçues comme un cadre qui bénéficie de règles spécifiques de redimensionnement.

Lorsque la propriété scale9Grid est définie et qu’un objet d’affichage est redimensionné, la totalité du texte et les dégradés sont dimensionnés normalement ; toutefois, les règles suivantes s’appliquent pour les autres types d’objets :

• Le contenu de la zone centrale est redimensionné normalement.
• Le contenu apparaissant dans les coins n’est pas redimensionné.
• Le contenu des zones supérieures et inférieures est redimensionné horizontalement uniquement. Le contenu apparaissant dans les zones de gauche et de droite est redimensionné verticalement uniquement.
• Tous les remplissages (ce qui inclut les bitmaps, les vidéos et les dégradés) sont étirés pour remplir leur forme.

Si vous faites pivoter un objet d’affichage, tout redimensionnement effectué ultérieurement est normal et la propriété scale9Grid est ignorée.

Par exemple, considérez l’objet d’affichage suivant et un rectangle qui lui est appliqué en tant que propriété scale9Grid :

Objet d’affichage.

Le rectangle rouge représente la zone couverte par scale9Grid.

Lorsque l’objet d’affichage est redimensionné ou étiré, les objets placés dans le rectangle se redimensionnent normalement. Par contre, les objets situés en dehors du rectangle sont redimensionnés selon les règles de scale9Grid :

Redimensionné à 75 % :
Redimensionné à 50 % :
Redimensionné à 25 % :
Etiré à l’horizontal à 150 % :

L’une des principales utilisations de scale9Grid consiste à définir un objet d’affichage en tant que composant où les zones de bordure conservent la même largeur lorsque le composant est redimensionné.

Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. Le point d’alignement par défaut est (0,0). 1.0 correspond à une échelle 100 %.

La mise à l’échelle du système de coordonnées local modifie les valeurs des propriétés x et y définies en pixels.

Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. Le point d’alignement par défaut est (0,0). 1.0 correspond à une échelle 100 %.

La mise à l’échelle du système de coordonnées local modifie les valeurs des propriétés x et y définies en pixels.

Cadre de sélection du défilement de l’objet d’affichage. L’objet d’affichage est recadré en fonction de la taille définie par le rectangle et il défile au sein de ce dernier lorsque vous modifiez les propriétés x et y de l’objet scrollRect.

Les propriétés de l’objet rectangle scrollRect reprennent l’espace de coordonnées de l’objet d’affichage et sont redimensionnées tout comme l’objet d’affichage global. Les angles de la fenêtre recadrée de l’objet d’affichage avec défilement correspondent à l’origine de l’objet d’affichage (0,0) et le point défini par la largeur et la hauteur du rectangle. Ils ne sont pas centrés autour de l’origine, mais utilisent cette dernière pour définir le coin supérieur gauche de la zone. L’objet d’affichage avec défilement se fait toujours par pixels entiers.

Vous pouvez faire défiler un objet vers la gauche ou la droite en définissant la propriété x de l’objet rectangle scrollRect. Vous pouvez faire défiler un objet vers le haut ou le bas en définissant la propriété y de l’objet rectangle scrollRect. Si l’objet d’affichage subit une rotation de 90° et que vous le faites défiler vers la gauche ou vers la droite, il défile en fait vers le haut ou vers le bas.

Notez que les modifications apportées à la propriété scrollRect sont uniquement traitées lors du rendu de l’objet. Par conséquent, les méthodes comme localToGlobal risquent de ne pas produire les résultats escomptés si elles sont appelées immédiatement après la modification de scrollRect.

Remarque : à partir de Flash Player 11.4 /AIR 3.4, les valeurs négatives de largeur ou de hauteur du rectangle sont automatiquement définies sur 0.

Scène de l’objet d’affichage. L’application d’un moteur d’exécution de Flash ne possède qu’un seul objet Stage. Par exemple, vous pouvez créer et charger plusieurs objets d’affichage dans la liste d’affichage. La propriété stage de chaque objet d’affichage se rapporte au même objet Stage (même si l’objet d’affichage appartient à un fichier SWF chargé).

Si un objet d’affichage n’est pas ajouté à la liste d’affichage, sa propriété stage est définie sur null.

Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. Les propriétés spécifiques, telles que matrix, colorTransform et trois propriétés en lecture seule (concatenatedMatrix, concatenatedColorTransform et pixelBounds) sont décrites dans la section relative à la classe Transform.

Chacune des propriétés de l’objet transform constitue un objet. Ce concept est important dans la mesure où la seule façon de définir de nouvelles valeurs pour les objets matrix ou colorTransform consiste à créer un objet et à le copier dans la propriété transform.matrix ou transform.colorTransform.

Par exemple, pour augmenter la valeur tx d’une matrice d’objet d’affichage, vous devez copier l’ensemble de l’objet de la matrice, puis copier le nouvel objet dans la propriété matrix de l’objet transform :

    var myMatrix:Matrix = myDisplayObject.transform.matrix;  
    myMatrix.tx += 10; 
    myDisplayObject.transform.matrix = myMatrix;  
    

Vous ne pouvez pas définir directement la propriété tx. Le code suivant n’a pas d’effet sur myDisplayObject :

    myDisplayObject.transform.matrix.tx += 10;
    

Vous pouvez copier un objet transform et l’associer à la propriété transform d’un autre objet d’affichage. Par exemple, le code suivant copie l’objet transform dans son intégralité, de myOldDisplayObj à myNewDisplayObj :

Le nouvel objet d’affichage qui en résulte, myNewDisplayObj, dispose désormais des mêmes valeurs pour ses paramètres de matrice, transformation de couleurs et limites de pixels que l’ancien objet d’affichage, myOldDisplayObj.

Notez que les périphériques AIR pour TV font appel à l’accélération matérielle, si elle est disponible, pour les transformations de couleur.

Indique si l’objet d’affichage est visible ou non. Les objets d’affichage qui ne sont pas visibles sont désactivés. Par exemple, si visible=false pour une occurrence InteractiveObject, il est impossible de cliquer sur cette dernière.

Indique la largeur de l’objet d’affichage, en pixels. La largeur est calculée en fonction des limites du contenu de l’objet d’affichage. Lorsque vous définissez la propriété width, la propriété scaleX est ajustée en conséquence, comme illustré dans le code suivant :

    var rect:Shape = new Shape();
    rect.graphics.beginFill(0xFF0000);
    rect.graphics.drawRect(0, 0, 100, 100);
    trace(rect.scaleX) // 1;
    rect.width = 200;
    trace(rect.scaleX) // 2;

A l’exception des objets TextField et Video, un objet d’affichage sans contenu (comme un sprite vide) a une largeur de 0, même si vous essayez de définir width sur une valeur différente.

Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. Si l’objet figure dans un objet DisplayObjectContainer qui dispose de transformations, ce dernier figure dans le système de coordonnées locales de l’objet DisplayObjectContainer qui l’englobe. Ainsi, dans le cas d’un objet DisplayObjectContainer qui a subi une rotation de 90 ° dans le sens inverse des aiguilles d’une montre, les enfants de DisplayObjectContainer héritent d’un système de coordonnées ayant effectué une rotation à 90 ° dans le sens inverse des aiguilles d’une montre. Les coordonnées de l’objet renvoient à la position du point d’alignement.

Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. Si l’objet figure dans un objet DisplayObjectContainer qui dispose de transformations, ce dernier figure dans le système de coordonnées locales de l’objet DisplayObjectContainer qui l’englobe. Ainsi, dans le cas d’un objet DisplayObjectContainer qui a subi une rotation de 90 ° dans le sens inverse des aiguilles d’une montre, les enfants de DisplayObjectContainer héritent d’un système de coordonnées ayant effectué une rotation à 90 ° dans le sens inverse des aiguilles d’une montre. Les coordonnées de l’objet renvoient à la position du point d’alignement.

Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. Consultez le code suivant, qui indique comment le rectangle renvoyé peut varier en fonction du paramètre targetCoordinateSpace que vous transmettez à la méthode :

     var container:Sprite = new Sprite();
     container.x = 100;
     container.y = 100;
     this.addChild(container);
     var contents:Shape = new Shape();
     contents.graphics.drawCircle(0,0,100);
     container.addChild(contents);
     trace(contents.getBounds(container));
      // (x=-100, y=-100, w=200, h=200)
     trace(contents.getBounds(this));
      // (x=0, y=0, w=200, h=200)
     

Remarque : utilisez les méthodes localToGlobal() et globalToLocal() pour convertir les coordonnées locales de l’objet d’affichage en coordonnées d’affichage, ou pour convertir les coordonnées d’affichage en coordonnées locales.

La méthode getBounds() est semblable à la méthode getRect(). Cependant, le rectangle renvoyé par la méthode getBounds() inclut les traits appliqués aux formes, contrairement au rectangle renvoyé par la méthode getRect(). Pour consulter un exemple d’utilisation de la méthode getRect(), reportez-vous à la description correspondante.

Paramètres

Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes. Les valeurs renvoyées par la méthode getRect() sont inférieures ou égales à celles qui sont renvoyées par la méthode getBounds().

Remarque : utilisez les méthodes localToGlobal() et globalToLocal() pour convertir les coordonnées locales de l’objet d’affichage en coordonnées de scène, ou pour convertir les coordonnées de scène en coordonnées locales.

Paramètres

Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).

Pour utiliser cette méthode, commencez par créer une occurrence de la classe Point. Les valeurs x et y que vous affectez représentent des coordonnées globales dans la mesure où elles se référent à l’origine (0,0) de la zone d’affichage principal. Passez ensuite l’occurrence Point en tant que paramètre à la méthode globalToLocal(). La méthode renvoie un nouvel objet Point avec des valeurs x et y qui se rapportent à l’origine de l’objet d’affichage et non pas à l’origine de la scène.

Paramètres

Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj.

Paramètres

Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. Les paramètres x et y spécifient un point dans l’espace de coordonnées de la scène et non pas le conteneur d’objet d’affichage qui contient l’objet d’affichage (sauf si ce conteneur correspond à la scène).

Paramètres

Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).

Cette méthode permet de convertir les coordonnées x et y des valeurs qui se rapportent à l’origine (0,0) d’un objet d’affichage spécifique (coordonnées locales) en valeurs qui se rapportent à l’origine de la scène (coordonnées globales).

Pour utiliser cette méthode, commencez par créer une occurrence de la classe Point. Les valeurs x et y que vous affectez représentent des coordonnées locales dans la mesure où elles se référent à l’origine de l’objet d’affichage principal.

Vous transmettez ensuite l’occurrence de Point que vous avez créée en tant que paramètre à la méthode localToGlobal(). La méthode renvoie un nouvel objet Point avec des valeurs x et y qui se rapportent à l’origine de la scène et non pas à l’origine de l’objet d’affichage.

Paramètres

Déplace cet objet vers les coordonnées x et y spécifiées.

Paramètres

Définit la taille réelle de cet objet.

Cette méthode est principalement utilisée dans le cadre de l’implémentation de la méthode updateDisplayList(), qui permet de calculer la taille réelle de l’objet, en fonction de sa taille explicite, de sa taille par rapport au parent (pourcentage) et de sa taille mesurée. Vous pouvez ensuite appliquer cette taille réelle à l’objet en appelant la méthode setActualSize().

Dans d’autres situations, il est préférable de définir les propriétés telles que width, height, percentWidth et percentHeight plutôt que d’appeler cette méthode.

Paramètres