| Package | spark.primitives |
| Classe | public class BitmapImage |
| Héritage | BitmapImage  GraphicElement EventDispatcher Object |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Plus d’exemples
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | alpha : Number
Niveau de transparence de l’élément graphique. | GraphicElement | |
| alwaysCreateDisplayObject : Boolean
Spécifie que cet objet GraphicElement doit être associé à sa propre classe DisplayObject et rendu dans cette dernière. | GraphicElement | |
| baseline : Object
Distance verticale en pixels de la cible d’ancrage à la position de ligne de base du contrôle. | GraphicElement | |
| baselinePosition : Number [lecture seule]
Coordonnée y de la ligne de base de la première ligne de texte du composant. | GraphicElement | |
| bitmapData : BitmapData [lecture seule]
Renvoie une copie de l’objet BitmapData représentant le contenu d’image actuellement chargé (non redimensionné). | BitmapImage | ||
| blendMode : String
Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser. | GraphicElement | |
| bottom : Object
Distance verticale en pixels du bord inférieur du composant au bord inférieur de la cible d’ancrage. | GraphicElement | |
| bytesLoaded : Number [lecture seule]
Le nombre d’octets de l’image déjà chargée. | BitmapImage | ||
| bytesTotal : Number [lecture seule]
Les données d’image totales en octets chargés ou en attente de chargement. | BitmapImage | ||
| clearOnLoad : Boolean
Indique si le contenu de l’image précédente doit ou non être effacé avant le chargement d’un nouveau contenu. | BitmapImage | ||
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| contentLoader : IContentLoader
Loader d’image personnalisée facultatif (par exemple : | BitmapImage | ||
| contentLoaderGrouping : String
Identifiant de regroupement de contenu facultatif à transmettre à la méthode load() d’une instance de iContentLoader associée. | BitmapImage | ||
| depth : Number
Détermine l’ordre dans lequel les éléments sont rendus au sein des conteneurs. | GraphicElement | |
| designLayer : DesignLayer
Spécifie l’instance DesignLayer facultative associée à cet élément visuel. | GraphicElement | |
| displayObject : DisplayObject [lecture seule]
Objet DisplayObject partagé où cet élément IGraphicElement est tracé. | GraphicElement | |
| displayObjectSharingMode : String
Indique l’association entre cette interface IGraphicElement et ses objets d’affichage. | GraphicElement | |
| explicitHeight : Number
Nombre définissant la hauteur explicite du composant en pixels, dans les coordonnées du composant. | GraphicElement | |
| explicitMaxHeight : Number
Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | GraphicElement | |
| explicitMaxWidth : Number
Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | GraphicElement | |
| explicitMinHeight : Number
Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | GraphicElement | |
| explicitMinWidth : Number
Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | GraphicElement | |
| explicitWidth : Number
Nombre définissant la largeur explicite du composant en pixels, dans les coordonnées du composant. | GraphicElement | |
| fillMode : String
Détermine la manière dont l’image bitmap remplit les dimensions. | BitmapImage | ||
| filters : Array
Tableau indexé contenant tous les objets filtre actuellement associés à l’élément graphique. | GraphicElement | |
| hasLayoutMatrix3D : Boolean [lecture seule]
Contient true si l’élément possède une matrice 3D. | GraphicElement | |
| height : Number
Hauteur de l’élément graphique. | GraphicElement | |
| horizontalAlign : String
Alignement horizontal du contenu lorsqu’il ne présente pas de proportions 1/1 en pixels et que scaleMode est défini sur mx.graphics.BitmapScaleMode.LETTERBOX. | BitmapImage | ||
| horizontalCenter : Object
Distance horizontale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage. | GraphicElement | |
| id : String
Identité du composant. | GraphicElement | |
| includeInLayout : Boolean
Spécifie si cet élément est inclus dans la présentation du parent. | GraphicElement | |
| is3D : Boolean [lecture seule]
Contient true lorsque l’élément est en 3D. | GraphicElement | |
| 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). | GraphicElement | |
| left : Object
Distance horizontale en pixels du bord gauche du composant au bord gauche de la cible d’ancrage. | GraphicElement | |
| luminosityClip : Boolean
Propriété qui contrôle si le masque de luminosité écrête le contenu masqué. | GraphicElement | |
| luminosityInvert : Boolean
Une propriété qui contrôle le calcul de la valeur de couleur RVB d’un élément graphique masqué par un masque de luminosité. | GraphicElement | |
| mask : DisplayObject
L’objet d’affichage appelant est masqué par l’objet mask spécifié. | GraphicElement | |
| maskType : String
Définit la façon dont le masque est appliqué à l’élément GraphicElement. Les valeurs possibles sont MaskType.CLIP, MaskType.ALPHA et MaskType.LUMINOSITY. Masquage d’écrêtage : lors d’un masquage en mode écrêtage, un masque d’écrêtage est réduit à 1 bit. | GraphicElement | |
| maxHeight : Number
Hauteur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | GraphicElement | |
| maxWidth : Number
Largeur maximale recommandée du composant à prendre en compte par le parent lors de la présentation. | GraphicElement | |
| measuredHeight : Number
Hauteur par défaut du composant, en pixels. | GraphicElement | |
| measuredWidth : Number
Largeur par défaut du composant, en pixels. | GraphicElement | |
| measuredX : Number
Coin supérieur gauche des limites mesurées par défaut par rapport à l’origine de l’élément. | GraphicElement | |
| measuredY : Number
Coin supérieur gauche des limites mesurées par défaut par rapport à l’origine de l’élément. | GraphicElement | |
| minHeight : Number
Hauteur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | GraphicElement | |
| minWidth : Number
Largeur minimale recommandée du composant à prendre en compte par le parent lors de la présentation. | GraphicElement | |
| owner : DisplayObjectContainer
Propriétaire de cet objet IVisualElement. | GraphicElement | |
| parent : DisplayObjectContainer [lecture seule]
Conteneur ou composant parent de ce composant. | GraphicElement | |
| percentHeight : Number
Spécifie la hauteur d’un composant en tant que pourcentage de la taille de son parent. | GraphicElement | |
| percentWidth : Number
Spécifie la largeur d’un composant en tant que pourcentage de la taille de son parent. | GraphicElement | |
| postLayoutTransformOffsets : mx.geom:TransformOffsets
Définit un ensemble de réglages pouvant être appliqué à la transformation d’un objet de manière invisible pour la présentation de son parent. | GraphicElement | |
| preliminaryHeight : Number
Fournit une estimation à utiliser pour la hauteur lorsque les limites « mesurées » de l’image sont demandées par la mise en page, mais que le chargement des données d’image n’est pas terminé. | BitmapImage | ||
| preliminaryWidth : Number
Fournit une estimation à utiliser pour la largeur lorsque les limites « mesurées » de l’image sont demandées par la mise en page, mais que le chargement des données d’image n’est pas terminé. | BitmapImage | ||
| right : Object
Distance horizontale en pixels du bord droit du composant au bord droit de la cible d’ancrage. | GraphicElement | |
| rotation : Number
Indique la rotation de l’élément, en degrés, à partir du point de transformation. | GraphicElement | |
| rotationX : Number
Indique la rotation de l’axe des x de l’instance de l’élément, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | GraphicElement | |
| rotationY : Number
Indique la rotation de l’axe des y de l’instance DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent. | GraphicElement | |
| rotationZ : Number
Indique la rotation de l’élément, en degrés, à partir du point de transformation. | GraphicElement | |
| scaleMode : String
Détermine comment l’image est redimensionnée lorsque fillMode est défini sur mx.graphics.BitmapFillMode.SCALE. | BitmapImage | ||
| scaleX : Number
Echelle horizontale (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation. | GraphicElement | |
| scaleY : Number
Echelle verticale (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation. | GraphicElement | |
| scaleZ : Number
Echelle z (pourcentage) de l’élément telle qu’elle est appliquée à partir du point de transformation. | GraphicElement | |
| smooth : Boolean
Indique si un algorithme de lissage doit être appliqué à l’image bitmap. | BitmapImage | ||
| smoothingQuality : String
Détermine la réduction de l’image. | BitmapImage | ||
| source : Object
Source utilisée pour le remplissage de bitmap. | BitmapImage | ||
| sourceHeight : Number [lecture seule]
Fournit la hauteur non redimensionnée des données d’image d’origine. | BitmapImage | ||
| sourceWidth : Number [lecture seule]
Fournit la largeur non redimensionnée des données d’image d’origine. | BitmapImage | ||
| top : Object
Distance verticale en pixels du bord supérieur du composant au bord supérieur de la cible d’ancrage. | GraphicElement | |
| 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. | GraphicElement | |
| transformX : Number
Point de transformation de la position x de l’élément. | GraphicElement | |
| transformY : Number
Point de transformation de la position y de l’élément. | GraphicElement | |
| transformZ : Number
Point de transformation de la position z de l’élément. | GraphicElement | |
| trustedSource : Boolean [lecture seule]
Lecture seule indiquant si l’indicateur actuellement contenu chargé est considéré comme chargé forment une source dont la sécurité permet d’accéder aux images entre différents domaines. | BitmapImage | ||
| verticalAlign : String
Alignement vertical du contenu lorsqu’il n’a pas de proportions 1/1 en pixels et que scaleMode est défini sur mx.graphics.BitmapScaleMode.LETTERBOX. | BitmapImage | ||
| verticalCenter : Object
Distance verticale en pixels du centre du composant au centre de la zone de contenu de la cible d’ancrage. | GraphicElement | |
| visible : Boolean
Contrôle la visibilité de cet élément visuel. | GraphicElement | |
| width : Number
Largeur de l’élément graphique. | GraphicElement | |
| x : Number
Position x de l’élément graphique. | GraphicElement | |
| y : Number
Position y de l’élément graphique. | GraphicElement | |
| z : Number
Position z de l’élément graphique. | GraphicElement | |
| Méthode | Défini par | ||
|---|---|---|---|
Constructeur. | BitmapImage | ||
| 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 | |
|
Renvoie true si cette classe IGraphicElement est compatible et peut partager des objets d’affichage avec la classe IGraphicElement suivante dans la séquence. | GraphicElement | |
|
Renvoie true si cette classe IGraphicElement est compatible et peut partager des objets d’affichage avec la classe IGraphicElement précédente dans la séquence. | GraphicElement | |
|
Crée un nouvel objet DisplayObject où cet élément IGraphicElement est tracé. | GraphicElement | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée. | GraphicElement | |
|
Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée. | GraphicElement | |
|
Renvoie la hauteur de présentation de l’élément. | GraphicElement | |
|
Renvoie la largeur de la présentation de l’élément. | GraphicElement | |
|
Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran. | GraphicElement | |
|
Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran. | GraphicElement | |
|
Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères. | GraphicElement | |
|
Renvoie la matrice Matrix3D de transformation de présentation pour cet élément. | GraphicElement | |
|
Renvoie la hauteur maximale de l’élément. | GraphicElement | |
|
Renvoie la largeur maximale de l’élément. | GraphicElement | |
|
Renvoie la hauteur minimale de l’élément. | GraphicElement | |
|
Renvoie la largeur minimale de l’élément. | GraphicElement | |
|
Renvoie la hauteur préférée de l’élément. | GraphicElement | |
|
Renvoie la largeur préférée de l’élément. | GraphicElement | |
|
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 | |
|
Appelée automatiquement par le compilateur MXML lorsqu’une instance GraphicElement est créée en utilisant une balise MXML. | GraphicElement | |
|
L’appel de cette méthode provoque l’appel de la méthode validateDisplayList() de l’élément avant le rendu de la liste d’affichage. | GraphicElement | |
|
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. | GraphicElement | |
|
L’appel de cette méthode provoque l’appel de la méthode validateProperties() de l’élément avant le rendu de la liste d’affichage. | GraphicElement | |
|
L’appel de cette méthode provoque l’appel de la méthode validateSize() de l’élément avant le rendu de la liste d’affichage. | GraphicElement | |
|
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 l’objet point des coordonnées de l’objet (locales) vers les coordonnées de la scène (globales). | GraphicElement | |
|
Appelé par l’objet IGraphicElementContainer lorsqu’un élément IGraphicElement est ajouté ou supprimé à partir du composant hôte. | GraphicElement | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
| setLayoutBoundsPosition(newBoundsX:Number, newBoundsY:Number, postLayoutTransform:Boolean = true):void
Définit les coordonnées utilisées par l’élément pour son affichage à l’écran. | GraphicElement | |
|
Définit la taille de la présentation de l’élément. | GraphicElement | |
|
Définit la matrice de transformation utilisée pour calculer la taille de présentation et la position du composant par rapport à ses frères. | GraphicElement | |
|
Définit la matrice de transformation Matrix3D utilisée pour calculer la taille et la position de la présentation du composant par rapport à ses frères. | GraphicElement | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Détermine si cet élément peut ou non se tracer lui-même sur l’objet sharedDisplayObject de la séquence. | GraphicElement | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
| transformAround(transformCenter:Vector3D, scale:Vector3D = null, rotation:Vector3D = null, translation:Vector3D = null, postLayoutScale:Vector3D = null, postLayoutRotation:Vector3D = null, postLayoutTranslation:Vector3D = null, invalidateLayout:Boolean = true):void
Méthode d’utilitaire permettant de mettre à jour la rotation, la mise à l’échelle et la translation de la transformation tout en conservant un point particulier, spécifié dans l’espace de coordonnées du composant, fixe dans l’espace de coordonnées du parent. | GraphicElement | |
|
Méthode utilitaire permettant de transformer un point spécifié dans les coordonnées locales de cet objet en emplacement dans les coordonnées du parent de l’objet. | GraphicElement | |
|
Appelé par l’objet IGraphicElementContainer pour retracer cet élément dans sa propriété displayObject. | GraphicElement | |
|
Valide et met à jour les propriétés et la mise en forme de cet objet en appelant immédiatement les méthodes validateProperties(), validateSize() et validateDisplayList() lorsque cela est nécessaire. | GraphicElement | |
|
Utilisé par la logique de présentation pour valider les propriétés d’un composant par l’appel de la méthode commitProperties(). | GraphicElement | |
|
Appelé par l’objet IGraphicElementContainer pour valider la taille de cet élément. | GraphicElement | |
|
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 | |
| Méthode | Défini par | ||
|---|---|---|---|
|
Détermine si l’appel à la méthode measure() peut être ignoré. | GraphicElement | |
[override]
Traite le jeu de propriétés sur l’élément. | BitmapImage | ||
|
Renvoie la quantité de pixels occupée par le trait de chaque côté des limites de l’élément. | GraphicElement | |
|
Méthode d’utilitaire qui avertit l’hôte que cet élément a changé et que son calque doit être mis à jour. | GraphicElement | |
|
Méthode d’assistance permettant d’invalider la taille du parent et la liste d’affichage si cet objet affecte sa présentation (includeInLayout est défini sur true). | GraphicElement | |
[override]
Calcule la taille par défaut de l’élément. | BitmapImage | ||
|
Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de hauteur mesurée. | GraphicElement | |
|
Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de largeur mesurée. | GraphicElement | |
|
Transforme la taille de l’élément. | GraphicElement | |
|
Transforme la taille de l’élément. | GraphicElement | |
[override]
Trace l’élément et/ou dimensionne et positionne son contenu. | BitmapImage | ||
| Evénement | Synthèse | Défini par | ||
|---|---|---|---|---|
| [Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active. | EventDispatcher | ||
| Distribué lorsque le chargement du contenu est terminé. | BitmapImage | |||
| [Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive. | EventDispatcher | ||
| Distribué lorsqu’une requête réseau est envoyée via le protocole HTTP et que Flash Player ou AIR peut détecter le code d’état HTTP. | BitmapImage | |||
| Distribué lorsqu’une erreur d’entrée/sortie se produit. | BitmapImage | |||
| Distribué lors du chargement de contenu. | BitmapImage | |||
| Distribué lorsque le chargement du contenu est terminé. | BitmapImage | |||
| Distribué lorsqu’une erreur de sécurité se produit. | BitmapImage | |||
bitmapData | propriété |
bitmapData:BitmapData [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Renvoie une copie de l’objet BitmapData représentant le contenu d’image actuellement chargé (non redimensionné). Cette propriété est null pour le contenu non fiable interdomaines.
La valeur par défaut est null.
Implémentation
public function get bitmapData():BitmapDatabytesLoaded | propriété |
bytesLoaded:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Le nombre d’octets de l’image déjà chargée. Concerne uniquement les images chargées par une URL de requête.
La valeur par défaut est NaN.
Implémentation
public function get bytesLoaded():NumberbytesTotal | propriété |
bytesTotal:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Les données d’image totales en octets chargés ou en attente de chargement. Concerne uniquement les images chargées par une URL de requête.
La valeur par défaut est NaN.
Implémentation
public function get bytesTotal():NumberclearOnLoad | propriété |
clearOnLoad:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Indique si le contenu de l’image précédente doit ou non être effacé avant le chargement d’un nouveau contenu.
La valeur par défaut est true.
Implémentation
public function get clearOnLoad():Boolean public function set clearOnLoad(value:Boolean):voidcontentLoader | propriété |
contentLoader:IContentLoader| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Loader d’image personnalisée facultatif (par exemple mémoire cache ou file d’attente d’images) à associer au client loader de contenu.
La valeur par défaut est null.
Implémentation
public function get contentLoader():IContentLoader public function set contentLoader(value:IContentLoader):voidcontentLoaderGrouping | propriété |
contentLoaderGrouping:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Identifiant de regroupement de contenu facultatif à transmettre à la méthode load() d’une instance de iContentLoader associée. Cette propriété n’est prise en compte que lorsqu’un contentLoader valide est chargé.
Implémentation
public function get contentLoaderGrouping():String public function set contentLoaderGrouping(value:String):voidfillMode | propriété |
fillMode:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Détermine la manière dont l’image bitmap remplit les dimensions. Si vous définissez la valeur de cette propriété dans une balise, utilisez la chaîne (par exemple, « repeat »). Si vous définissez la valeur de cette propriété dans ActionScript, utilisez la constante (par exemple, mx.graphics.BitmapFillMode.CLIP).
Lorsque cette valeur est définie sur BitmapFillMode.CLIP (« clip »), le bitmap se termine sur le bord de la région.
Lorsque cette valeur est définie sur BitmapFillMode.REPEAT (« repeat »), l’image bitmap se répète pour remplir la région.
Lorsque cette valeur est définie sur BitmapFillMode.SCALE (« scale »), l’image bitmap s’étire pour remplir la région.
La valeur par défaut est BitmapFillMode.SCALE.
Implémentation
public function get fillMode():String public function set fillMode(value:String):voidEléments de l’API associés
horizontalAlign | propriété |
horizontalAlign:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Alignement horizontal du contenu lorsqu’il ne présente pas de proportions 1/1 en pixels et que scaleMode est défini sur mx.graphics.BitmapScaleMode.LETTERBOX.
Peut être HorizontalAlign.LEFT (« gauche »), HorizontalAlign.RIGHT (« droite ») ou HorizontalAlign.CENTER (« centre »).
Cette propriété s’applique uniquement lorsque fillMode est défini sur mx.graphics.BitmapFillMode.SCALE ("scale").
La valeur par défaut est HorizontalAlign.CENTER.
Implémentation
public function get horizontalAlign():String public function set horizontalAlign(value:String):voidEléments de l’API associés
preliminaryHeight | propriété |
preliminaryHeight:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Fournit une estimation à utiliser pour la hauteur lorsque les limites « mesurées » de l’image sont demandées par la mise en page, mais que le chargement des données d’image n’est pas terminé. Lorsque NaN la hauteur mesurée est de 0 jusqu’à ce que le chargement de l’image soit terminé.
La valeur par défaut est NaN.
Implémentation
public function get preliminaryHeight():Number public function set preliminaryHeight(value:Number):voidpreliminaryWidth | propriété |
preliminaryWidth:Number| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Fournit une estimation à utiliser pour la largeur lorsque les limites « mesurées » de l’image sont demandées par la mise en page, mais que le chargement des données d’image n’est pas terminé. Quand NaN, la largeur mesurée est de 0 jusqu’à ce que le chargement de l’image soit terminé.
La valeur par défaut est NaN.
Implémentation
public function get preliminaryWidth():Number public function set preliminaryWidth(value:Number):voidscaleMode | propriété |
scaleMode:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10.1, AIR 2.0 |
Détermine comment l’image est redimensionnée lorsque fillMode est défini sur mx.graphics.BitmapFillMode.SCALE.
Lorsque ce paramètre est défini sur mx.graphics.BitmapScaleMode.STRETCH ("stretch"), l’image est étirée pour adapter sa taille.
Lorsque ce paramètre est défini sur BitmapScaleMode.Letterbox (« letterbox »), l’image est redimensionnée selon les proportions de l’image non redimensionnée d’origine.
Lorsque ce paramètre est défini sur BitmapScaleMode.ZOOM ("zoom"), l’image est mise à l’échelle en respectant les proportions d’origine. Ceci entraîne un recadrage sur un seul axe.
La valeur par défaut est BitmapScaleMode.STRETCH.
Implémentation
public function get scaleMode():String public function set scaleMode(value:String):voidEléments de l’API associés
smooth | propriété |
smooth:Boolean| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Indique si un algorithme de lissage doit être appliqué à l’image bitmap.
Si la valeur est false, les images bitmap agrandies sont rendues en appliquant un algorithme d’approximation et ont un aspect pixélisé. Si la valeur est true, les images bitmap agrandies sont rendues avec un algorithme bilinéaire. Les rendus qui résultent de l’utilisation de l’algorithme d’approximation sont généralement plus rapides.
La valeur par défaut est false.
Implémentation
public function get smooth():Boolean public function set smooth(value:Boolean):voidsmoothingQuality | propriété |
smoothingQuality:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Détermine la réduction de l’image. Lorsqu’elle est définie sur BitmapSmoothingQuality.HIGH, l’image est rééchantillonnée (si les données proviennent d’une source fiable) pour obtenir un résultat de qualité supérieure. Si défini sur BitmapSmoothingQuality.DEFAULT, la qualité d’image par défaut pour le fichier bitmap redimensionné est utilisée.
La valeur par défaut est BitmapSmoothingQuality.DEFAULT.
Implémentation
public function get smoothingQuality():String public function set smoothingQuality(value:String):voidsource | propriété |
source:Object| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Source utilisée pour le remplissage de bitmap. Le remplissage peut effectuer le rendu à partir de diverses sources graphiques, y compris les suivantes :
- Une instance Bitmap ou BitmapData.
- Une classe représentant une sous-classe de DisplayObject. La classe BitmapFill instancie la classe et en crée un rendu de bitmap.
- Une instance d’un objet DisplayObject. La classe BitmapFill la copie dans un bitmap en vue du remplissage.
- Le nom d’un fichier d’image externe.
Si vous utilisez un fichier image pour la source, il peut être de type PNG, GIF ou JPG.
Pour spécifier une image incrustée en tant que source, vous pouvez utiliser la directive @Embed, comme l’illustre l’exemple suivant :
source="@Embed('<i>image_location</i>')"
L’emplacement de l’image peut être spécifié via une URL, une URLRequest ou une référence de fichier. S’il s’agit d’une référence de fichier, son emplacement est relatif à l’emplacement du fichier en cours de compilation.
La classe BitmapImage est conçue pour utiliser des images incorporées ou des images chargées lors de l’exécution.
Si la source est une instance Bitmap ou BitmapData ou est un fichiers d’image externe, il incombe à l’appelant de supprimer la source une fois qu’elle n’est plus nécessaire. Si ImageLoader a créé l’instance de BitmapData, il supprimera cette dernière une fois la source modifiée.
Cette propriété peut être utilisée comme source de la liaison de données. Lorsque cette propriété est modifiée, elle distribue l’événement sourceChanged .
Implémentation
public function get source():Object public function set source(value:Object):voidEléments de l’API associés
sourceHeight | propriété |
sourceHeight:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Fournit la hauteur non redimensionnée des données d’image d’origine.
La valeur par défaut est NaN.
Implémentation
public function get sourceHeight():NumbersourceWidth | propriété |
sourceWidth:Number [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Fournit la largeur non redimensionnée des données d’image d’origine.
La valeur par défaut est NaN.
Implémentation
public function get sourceWidth():NumbertrustedSource | propriété |
trustedSource:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 9, AIR 1.5 |
Lecture seule indiquant si l’indicateur actuellement contenu chargé est considéré comme chargé forment une source dont la sécurité permet d’accéder aux images entre différents domaines. Quand la valeur est false, les opérations bitmap avancées, telles que la mise à l’échelle de qualité supérieure et la juxtaposition, ne sont pas autorisées. Cet indicateur est défini une fois l’image entièrement chargée.
La valeur par défaut est true.
Implémentation
public function get trustedSource():BooleanverticalAlign | propriété |
verticalAlign:String| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Alignement vertical du contenu lorsqu’il n’a pas de proportions 1/1 en pixels et que scaleMode est défini sur mx.graphics.BitmapScaleMode.LETTERBOX.
Peut être VerticalAlign.TOP (« haut »), VerticalAlign.BOTTOM (« bas ») ou VerticalAlign.MIDDLE (« milieu »).
Cette propriété s’applique uniquement lorsque la propriété scaleMode est définie sur BitmapFillMode.scale (« échelle »).
La valeur par défaut est VerticalAlign.MIDDLE.
Implémentation
public function get verticalAlign():String public function set verticalAlign(value:String):voidEléments de l’API associés
BitmapImage | () | Constructeur |
public function BitmapImage()| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Constructeur.
commitProperties | () | méthode |
override protected function commitProperties():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Traite le jeu de propriétés sur l’élément. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe.
Vous n’appelez pas cette méthode directement. Flex appelle la méthode commitProperties() lorsque vous utilisez la méthode addElement() pour ajouter un élément à un conteneur IGraphicElementContainer tel que Group, ou lorsque vous appelez la méthode invalidateProperties() de l’élément. Les appels de la méthode commitProperties() sont réalisés avant les appels de la méthode measure(). Ainsi, vous pouvez définir des valeurs de propriété susceptibles d’être utilisées par la méthode measure().
Certains éléments possèdent des propriétés qui interagissent entre elles. En règle générale, il est préférable de traiter toutes ces propriétés en même temps au démarrage pour éviter d’avoir à réaliser plusieurs fois les mêmes opérations.
measure | () | méthode |
override protected function measure():void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Calcule la taille par défaut de l’élément. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de l’objet GraphicElement.
Vous n’appelez pas cette méthode directement. Flex appelle la méthode measure() lorsque l’élément est ajouté à un conteneur IGraphicElementContainer tel que Group par le biais de la méthode addElement() et lorsque la méthode invalidateSize() de l’élément est appelée.
Par défaut, vous définissez une hauteur et une largeur explicites d’un élément, et Flex n’appelle pas la méthode measure(), même si vous appelez explicitement la méthode invalidateSize(). Pour remplacer ce comportement, remplacez la méthode skipMeasure().
Dans votre remplacement de cette méthode, vous devez définir les propriétés measuredWidth et measuredHeight pour définir la taille par défaut. Si vous le souhaitez, vous pouvez définir les propriétés measuredX et measuredY pour définir le coin supérieur gauche des limites mesurées par défaut par rapport à l’origine de l’élément.
Le point de mesure conceptuel de la méthode measure() permet à l’élément de fournir ses propres limites naturelles ou intrinsèques comme valeur par défaut. Par conséquent, les propriétés measuredWidth et measuredHeight doivent être déterminées par des facteurs comme :
- La quantité de texte que le composant doit afficher.
- La taille d’une image JPEG affichée par le composant.
Dans certains cas, aucune méthode intrinsèque ne permet de déterminer les valeurs par défaut. Par exemple, la méthode measure() d’un élément GreenCircle simple peut simplement définir measuredWidth = 100 et measuredHeight = 100 pour indiquer une taille par défaut raisonnable. Dans d’autres cas, comme le contrôle TextArea, un calcul approprié (comme rechercher la hauteur et la largeur correctes qui permettront d’afficher tout le texte et respecteront les proportions d’un rectangle d’or) peut s’avérer trop long pour que cela en vaille la peine.
L’implémentation par défaut de measure() définit les valeurs des propriétés measuredWidth, measuredHeight, measuredX et measuredY sur 0.
updateDisplayList | () | méthode |
override protected function updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
Trace l’élément et/ou dimensionne et positionne son contenu. Il s’agit d’une méthode avancée que vous pouvez remplacer lorsque vous créez une sous-classe de l’objet GraphicElement.
Vous n’appelez pas cette méthode directement. Flex appelle la méthode updateDisplayList() lorsque le composant est ajouté à un conteneur IGraphicElementContainer tel que Group par le biais de la méthode addElement() et lorsque la méthode invalidateDisplayList() de l’élément est appelée.
Cette méthode est celle où vous procéderiez au traçage par programmation à l’aide des méthodes sur l’objet displayObject de l’élément telles que graphics.drawRect().
Paramètres
unscaledWidth:Number — Indique la largeur du composant, en pixels, des coordonnées du composant, quelle que soit la valeur de la propriété scaleX du composant.
| |
unscaledHeight:Number — Indique la hauteur du composant, en pixels, des coordonnées du composant, quelle que soit la valeur de la propriété scaleY du composant.
|
complete | Evénement |
flash.events.Eventpropriété Event.type =
flash.events.Event.COMPLETE| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Distribué lorsque le chargement du contenu est terminé. Cet événement n’est distribué que pour les sources basées sur des URL et des ByteArray (ces sources nécessitent un Loader).
Notez que, pour le contenu chargé à l’aide du Loader, les événements ready et complete sont distribués.
ready est distribué.
La constante Event.COMPLETE définit la valeur de la propriété type d’un objet événement complete.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau dont le chargement est terminé. |
httpStatus | Evénement |
flash.events.HTTPStatusEventpropriété HTTPStatusEvent.type =
flash.events.HTTPStatusEvent.HTTP_STATUS| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Distribué lorsqu’une requête réseau est envoyée via le protocole HTTP et que Flash Player ou AIR peut détecter le code d’état HTTP.
La constanteHTTPStatusEvent.HTTP_STATUS définit la valeur de la propriété type d’un objet événement httpStatus.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
status | Le code d’état HTTP renvoyé par le serveur. |
target | L’objet réseau recevant un code d’état HTTP. |
ioError | Evénement |
flash.events.IOErrorEventpropriété IOErrorEvent.type =
flash.events.IOErrorEvent.IO_ERROR| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Distribué lorsqu’une erreur d’entrée/sortie se produit.
Définit la valeur de la propriététype d’un objet d’événement ioError.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
errorID | Un numéro de référence associé à l’erreur spécifique (AIR uniquement). |
target | Objet réseau sur lequel l’erreur d’entrée/sortie s’est produite. |
text | Texte à afficher en tant que message d’erreur. |
Eléments de l’API associés
progress | Evénement |
flash.events.ProgressEventpropriété ProgressEvent.type =
flash.events.ProgressEvent.PROGRESS| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Distribué lors du chargement de contenu.
Remarque : il n’est pas assuré que l’événement progress soit distribué. L’événement complete peut être reçu sans qu’aucun événement progress ne soit distribué. Ceci peut se produire si le contenu chargé est un fichier local.
type d’un objet événement progress.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
bytesLoaded | Nombre d’éléments ou d’octets chargés lors du traitement de l’événement par l’écouteur. |
bytesTotal | Nombre total d’éléments ou d’octets qui seront chargés si le processus de chargement aboutit. |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet indiquant la progression. |
ready | Evénement |
mx.events.FlexEventpropriété FlexEvent.type =
mx.events.FlexEvent.READY| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Distribué lorsque le chargement du contenu est terminé. Contrairement à l’événement complete, cet événement est distribué pour tous les type de source.
Notez que, pour le contenu chargé à l’aide du Loader, les événements ready et complete sont distribués.
ready est distribué.
La constante FlexEvent.READY définit la valeur de la propriété type de l’objet d’un événement ready. Cet événement est distribué par les classes BitmapImage et Spark pour indiquer que la source de l’image affectée est entièrement chargée.
Les valeurs des propriétés de l’objet d’événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false |
returnValue | null |
currentTarget | Objet définissant l’écouteur d’événement qui traite l’événement. Par exemple, si vous utilisez myImage.addEventListener() pour enregistrer un écouteur d’événement, la valeur de la propriété currentTarget est myImage. |
target | Objet qui a distribué l’événement (il ne s’agit pas toujours de l’objet qui écoute l’événement). Pour accéder systématiquement à l’objet qui écoute l’événement, utilisez la propriété currentTarget. |
Type | FlexEvent.READY |
securityError | Evénement |
flash.events.SecurityErrorEventpropriété SecurityErrorEvent.type =
flash.events.SecurityErrorEvent.SECURITY_ERROR| Version du langage: | ActionScript 3.0 |
| Version du produit: | Flex 4.5 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 2.0 |
Distribué lorsqu’une erreur de sécurité se produit.
La constanteSecurityErrorEvent.SECURITY_ERROR définit la valeur de la propriété type d’un objet événement securityError.
Les propriétés de cet événement sont les suivantes :
| Propriété | Valeur |
|---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
currentTarget | L’objet qui traite activement l’objet Event avec un écouteur d’événements. |
target | Objet réseau signalant l’erreur de sécurité |
text | Texte à afficher en tant que message d’erreur. |
Eléments de l’API associés
<?xml version="1.0" encoding="utf-8"?>
<!-- BitmapGraphicExample.mxml -->
<s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark">
<s:Panel title="Bitmap Graphic Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<s:Group left="10" right="10" top="10" bottom="10">
<!-- Single image, not resized, not repeated. -->
<s:Graphic x="0" y="0">
<s:BitmapImage id="bg1" source="@Embed('assets/AirIcon12x12.gif')" fillMode="clip"/>
</s:Graphic>
<!-- Single image, scaled to fit specified dimensions. -->
<s:Graphic x="150" y="0">
<s:BitmapImage id="bg2" source="@Embed('assets/AirIcon12x12.gif')" width="60" height="60" fillMode="scale"/>
</s:Graphic>
<!-- Repeated image to fit specified dimensions. -->
<s:Graphic x="300" y="0">
<s:BitmapImage id="bg3" source="@Embed('assets/AirIcon12x12.gif')" width="120" height="120" fillMode="repeat"/>
</s:Graphic>
</s:Group>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 09:30 AM Z