| Package | mx.core |
| Classe | public class BitmapAsset |
| Héritage | BitmapAsset  FlexBitmap Bitmap DisplayObject EventDispatcher Object |
| Implémente | IFlexAsset, IFlexDisplayObject, ILayoutDirectionElement |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
L’image bitmap incorporée peut figurer dans un fichier JPEG, GIF ou PNG. Vous pouvez également incorporer un symbole bitmap figurant dans un fichier SWF produit par Flash. Dans chacun de ces cas, le compilateur MXML génère automatiquement une classe qui étend la classe BitmapAsset pour représenter l’image bitmap incorporée.
Généralement, il n’est pas nécessaire d’utiliser la classe BitmapAsset directement lors de l’écriture d’une application Flex. Par exemple, vous pouvez incorporer un fichier GIF et afficher l’image dans un contrôle d’image en écrivant le code suivant :
<mx:Image id="logo" source="@Embed(source='Logo.gif')"/>
ou l’utiliser comme image d’arrière-plan de l’application en syntaxe CSS en écrivant le code suivant :
<fx:Style>
@namespace mx "library://ns.adobe.com/flex/mx"
mx|Application {
backgroundImage: Embed(source="Logo.gif")
}
<fx:Style/>
sans devoir comprendre que le compilateur MXML crée automatiquement une sous-classe de BitmapAsset.
Cependant, il peut être utile de comprendre ce qui se passe au niveau du code ActionScript. Afin d’incorporer une image bitmap dans ActionScript, vous déclarez une variable de type Class pour lui ajouter des métadonnées [Embed]. Par exemple, incorporez un fichier GIF de la manière suivante :
[Bindable] [Embed(source="Logo.gif")] private var logoClass:Class;
Le compilateur MXML détecte l’extension .gif, transcode les données GIF dans le format bitmap utilisé par le lecteur, génère automatiquement une sous-classe de la classe BitmapAsset et définit la variable comme référence à cette classe auto-générée. Vous pouvez ensuite utiliser cette référence de classe pour créer des instances de la classe BitmapAsset à l’aide de l’opérateur new et utiliser les API de la classe BitmapAsset sur ces dernières :
var logo:BitmapAsset = BitmapAsset(new logoClass()); logo.bitmapData.noise(4);
Toutefois, il est rarement nécessaire de créer des instances BitmapAsset manuellement. En effet, les propriétés et styles liés aux images peuvent être définis sur une classe produisant une image. Les composants créent ainsi les instances d’image en tant que de besoin. Par exemple, pour afficher cette image dans un contrôle d’image, vous pouvez définir la propriété source de l’image sur logoClass. Dans MXML, procédez de la manière suivante :
<mx:Image id="logo" source="{logoClass}"/>
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | accessibilityProperties : AccessibilityProperties
Options d’accessibilité actuelles de l’objet d’affichage. | DisplayObject | |
| alpha : Number
Indique la valeur de transparence alpha de l’objet spécifié. | DisplayObject | |
| bitmapData : BitmapData
Objet BitmapData référencé. | Bitmap | |
| blendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | DisplayObject | |
| blendShader : Shader [écriture seule]
Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan. | DisplayObject | |
| cacheAsBitmap : Boolean
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. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true. | DisplayObject | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage. | DisplayObject | |
| height : Number
Indique la hauteur de l’objet d’affichage, en pixels. | DisplayObject | |
| layoutDirection : String
Spécifie la direction de mise en forme souhaitée pour un élément : l’une des valeurs LayoutDirection.LTR (de gauche à droite), LayoutDirection.RTL (de droite à gauche) ou null (héritée). | BitmapAsset | ||
| loaderInfo : LoaderInfo [lecture seule]
Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage. | DisplayObject | |
| mask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié. | DisplayObject | |
| measuredHeight : Number [lecture seule]
Hauteur mesurée de l’objet. | BitmapAsset | ||
| measuredWidth : Number [lecture seule]
Largeur mesurée de l’objet. | BitmapAsset | ||
| metaData : Object
Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject. | DisplayObject | |
| mouseX : Number [lecture seule]
Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | |
| mouseY : Number [lecture seule]
Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels. | DisplayObject | |
| name : String
Indique le nom d’occurrence de DisplayObject. | DisplayObject | |
| opaqueBackground : Object
Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique. | DisplayObject | |
| parent : DisplayObjectContainer [lecture seule]
Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage. | DisplayObject | |
| pixelSnapping : String
Contrôle si l’objet Bitmap est accroché ou non au pixel le plus proche. | Bitmap | |
| root : DisplayObject [lecture seule]
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. | DisplayObject | |
| rotation : Number
Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine. | DisplayObject | |
| rotationX : Number
Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| rotationY : Number
Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| rotationZ : Number
Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | DisplayObject | |
| scale9Grid : Rectangle
Grille de mise à l’échelle en vigueur. | DisplayObject | |
| scaleX : Number
Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. | DisplayObject | |
| scaleY : Number
Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement. | DisplayObject | |
| scaleZ : Number
Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement. | DisplayObject | |
| scrollRect : Rectangle
Cadre de sélection du défilement de l’objet d’affichage. | DisplayObject | |
| smoothing : Boolean
Contrôle si l’image bitmap est lissée lorsqu’elle est dimensionnée. | Bitmap | |
| stage : Stage [lecture seule]
Scène de l’objet d’affichage. | DisplayObject | |
| transform : flash.geom:Transform
Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage. | DisplayObject | |
| visible : Boolean
Indique si l’objet d’affichage est visible ou non. | DisplayObject | |
| width : Number
Indique la largeur de l’objet d’affichage, en pixels. | DisplayObject | |
| x : Number
Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | DisplayObject | |
| y : Number
Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent. | DisplayObject | |
| z : Number
Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent. | DisplayObject | |
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | BitmapAsset | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace. | DisplayObject | |
|
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. | DisplayObject | |
|
Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales). | DisplayObject | |
|
Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales). | DisplayObject | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
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. | DisplayObject | |
|
Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y. | DisplayObject | |
Un élément doit appeler cette méthode lorsque la direction de la mise en forme change ou lorsque la direction de la mise en forme de son parent change. | BitmapAsset | ||
|
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 | |
|
Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales). | DisplayObject | |
|
Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales). | DisplayObject | |
Déplace cet objet vers les coordonnées x et y spécifiées. | BitmapAsset | ||
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
Définit la taille réelle de cet objet. | BitmapAsset | ||
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
| [override]
Renvoie une chaîne indiquant l’emplacement de l’objet dans la hiérarchie des objets DisplayObject de l’application. | FlexBitmap | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
layoutDirection | propriété |
layoutDirection:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.1 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Spécifie la direction de mise en forme souhaitée pour un élément: l’une des valeurs LayoutDirection.LTR (de gauche à droite), LayoutDirection.RTL (de droite à gauche) ou null (héritée). Cette propriété est généralement soutenue par un style héritable. Si sa valeur est null, le style layoutDirection est défini sur undefined. Les classes telles que GraphicElement, qui mettent en œuvre ILayoutDirectionElement mais ne prennent pas en charge les styles, doivent en outre prendre en charge la valeur null pour cette propriété, ce qui signifie que la direction de la mise en forme doit être héritée de son parent.
Implémentation
public function get layoutDirection():String public function set layoutDirection(value:String):voidmeasuredHeight | propriété |
measuredHeight:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Implémentation
public function get measuredHeight():NumbermeasuredWidth | propriété |
measuredWidth:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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.
Implémentation
public function get measuredWidth():NumberBitmapAsset | () | Constructeur |
public function BitmapAsset(bitmapData:BitmapData = null, pixelSnapping:String = "auto", smoothing:Boolean = false)| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Constructeur.
ParamètresbitmapData:BitmapData (default = null) | |
pixelSnapping:String (default = "auto") | |
smoothing:Boolean (default = false) |
invalidateLayoutDirection | () | méthode |
public function invalidateLayoutDirection():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.1 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Un élément doit appeler cette méthode lorsque la direction de la mise en forme change ou lorsque la direction de la mise en forme de son parent change. Si celles-ci diffèrent, la méthode est chargée de la réflexion du contenu de l’élément et de la mise à jour de la transformation post-mise en forme de l’élément afin que les descendants héritent d’un système de coordonnées par symétrie. IVisualElements met généralement en œuvre la réflexion en utilisant postLayoutTransformOffsets pour réduire l’axe des abscisses par -1 et pour translater la coordonnée de l’axe des x de l’origine par la largeur de l’élément. L’effet net de cette transformation « miroir » est d’inverser la direction dans laquelle l’axe des abscisses augmente sans modifier l’emplacement de l’élément par rapport à l’origine de son parent.
move | () | méthode |
public function move(x:Number, y:Number):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Déplace cet objet vers les coordonnées x et y spécifiées.
Paramètres
x:Number — Nouvelle position x de l’objet.
| |
y:Number — Nouvelle position y de l’objet.
|
setActualSize | () | méthode |
public function setActualSize(newWidth:Number, newHeight:Number):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 3 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
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
newWidth:Number — Nouvelle largeur de l’objet.
| |
newHeight:Number — Nouvelle hauteur de l’objet.
|
Tue Jun 12 2018, 09:30 AM Z