BitmapImage

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

Un élément BitmapImage définit une région rectangulaire dans l’espace de coordonnées de son élément parent, rempli de données de bitmap tracées depuis un fichier source ou d’une URL source.

Consulter les exemples

Plus d’exemples

Select bitmap assets based on DPI

Propriétés publiques

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

Propriétés protégées

Masquer les propriétés protégées héritées

Afficher les propriétés protégées héritées

	Propriété		Défini par
		drawnDisplayObject : DisplayObject [lecture seule] Objet DisplayObject actuel, sur lequel est tracé l’élément GraphicElement.	GraphicElement
		drawX : Number [lecture seule] Position x où l’élément doit être tracé.	GraphicElement
		drawY : Number [lecture seule] Position y où l’élément doit être tracé.	GraphicElement
		hasComplexLayoutMatrix : Boolean [lecture seule] Renvoie true si la classe GraphicElement possède des propriétés de transformation de non-translation (x,y)	GraphicElement
		layoutFeatures : AdvancedLayoutFeatures Contiennent tous les détails d’implémentation relatifs à la manière dont l’objet GraphicElement implémente la prise en charge de transformation et de présentation.	GraphicElement
		needsDisplayObject : Boolean [lecture seule] La valeur est true si l’élément requiert un objet DisplayObject exclusif.	GraphicElement

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		BitmapImage() 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
		canShareWithNext(element:IGraphicElement):Boolean 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
		canShareWithPrevious(element:IGraphicElement):Boolean 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
		createDisplayObject():DisplayObject Crée un nouvel objet DisplayObject où cet élément IGraphicElement est tracé.	GraphicElement
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getBoundsXAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Renvoie la coordonnée x des limites de l’élément à la taille d’élément spécifiée.	GraphicElement
		getBoundsYAtSize(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Renvoie la coordonnée y des limites de l’élément à la taille d’élément spécifiée.	GraphicElement
		getLayoutBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur de présentation de l’élément.	GraphicElement
		getLayoutBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur de la présentation de l’élément.	GraphicElement
		getLayoutBoundsX(postLayoutTransform:Boolean = true):Number Renvoie la coordonnée x que l’élément utilise pour dessiner à l’écran.	GraphicElement
		getLayoutBoundsY(postLayoutTransform:Boolean = true):Number Renvoie la coordonnée y utilisée par l’élément pour son affichage à l’écran.	GraphicElement
		getLayoutMatrix():Matrix Renvoie la matrice de transformation utilisée pour calculer la présentation du composant par rapport à ses frères.	GraphicElement
		getLayoutMatrix3D():Matrix3D Renvoie la matrice Matrix3D de transformation de présentation pour cet élément.	GraphicElement
		getMaxBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur maximale de l’élément.	GraphicElement
		getMaxBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur maximale de l’élément.	GraphicElement
		getMinBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur minimale de l’élément.	GraphicElement
		getMinBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur minimale de l’élément.	GraphicElement
		getPreferredBoundsHeight(postLayoutTransform:Boolean = true):Number Renvoie la hauteur préférée de l’élément.	GraphicElement
		getPreferredBoundsWidth(postLayoutTransform:Boolean = true):Number Renvoie la largeur préférée de l’élément.	GraphicElement
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d’un objet est définie.	Object
		initialized(document:Object, id:String):void Appelée automatiquement par le compilateur MXML lorsqu’une instance GraphicElement est créée en utilisant une balise MXML.	GraphicElement
		invalidateDisplayList():void 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
		invalidateLayoutDirection():void 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
		invalidateProperties():void 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
		invalidateSize():void 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
		isPrototypeOf(theClass:Object):Boolean 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
		localToGlobal(point:Point):Point Convertit l’objet point des coordonnées de l’objet (locales) vers les coordonnées de la scène (globales).	GraphicElement
		parentChanged(value:IGraphicElementContainer):void Appelé par l’objet IGraphicElementContainer lorsqu’un élément IGraphicElement est ajouté ou supprimé à partir du composant hôte.	GraphicElement
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 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
		setLayoutBoundsSize(width:Number, height:Number, postLayoutTransform:Boolean = true):void Définit la taille de la présentation de l’élément.	GraphicElement
		setLayoutMatrix(value:Matrix, invalidateLayout:Boolean):void 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
		setLayoutMatrix3D(value:Matrix3D, invalidateLayout:Boolean):void 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
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setSharedDisplayObject(sharedDisplayObject:DisplayObject):Boolean Détermine si cet élément peut ou non se tracer lui-même sur l’objet sharedDisplayObject de la séquence.	GraphicElement
		toLocaleString():String Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.	Object
		toString():String 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
		transformPointToParent(localPosition:Vector3D, position:Vector3D, postLayoutPosition:Vector3D):void 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
		validateDisplayList():void Appelé par l’objet IGraphicElementContainer pour retracer cet élément dans sa propriété displayObject.	GraphicElement
		validateNow():void 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
		validateProperties():void 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
		validateSize():void Appelé par l’objet IGraphicElementContainer pour valider la taille de cet élément.	GraphicElement
		valueOf():Object Renvoie la valeur primitive de l’objet spécifié.	Object
		willTrigger(type:String):Boolean 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éthodes protégées

Masquer les méthodes protégées héritées

Afficher les méthodes protégées héritées

	Méthode		Défini par
		canSkipMeasurement():Boolean Détermine si l’appel à la méthode measure() peut être ignoré.	GraphicElement
		commitProperties():void [override] Traite le jeu de propriétés sur l’élément.	BitmapImage
		getStrokeExtents(postLayoutTransform:Boolean = true):Rectangle Renvoie la quantité de pixels occupée par le trait de chaque côté des limites de l’élément.	GraphicElement
		invalidateDisplayObjectSharing():void Méthode d’utilitaire qui avertit l’hôte que cet élément a changé et que son calque doit être mis à jour.	GraphicElement
		invalidateParentSizeAndDisplayList():void 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
		measure():void [override] Calcule la taille par défaut de l’élément.	BitmapImage
		preferredHeightPreTransform():Number Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de hauteur mesurée.	GraphicElement
		preferredWidthPreTransform():Number Utilisé pour l’implémentation de l’interface ILayoutElement ; renvoie la valeur explicite de la prétransformation de largeur mesurée.	GraphicElement
		transformHeightForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Transforme la taille de l’élément.	GraphicElement
		transformWidthForLayout(width:Number, height:Number, postLayoutTransform:Boolean = true):Number Transforme la taille de l’élément.	GraphicElement
		updateDisplayList(unscaledWidth:Number, unscaledHeight:Number):void [override] Trace l’élément et/ou dimensionne et positionne son contenu.	BitmapImage

Evénements

Cliquez pour plus d’informations sur les événements

Masquer les événements hérités

Afficher les événements hérités

	Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.	EventDispatcher
complete	Distribué lorsque le chargement du contenu est terminé.	BitmapImage
deactivate	[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.	EventDispatcher
httpStatus	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
ioError	Distribué lorsqu’une erreur d’entrée/sortie se produit.	BitmapImage
progress	Distribué lors du chargement de contenu.	BitmapImage
ready	Distribué lorsque le chargement du contenu est terminé.	BitmapImage
securityError	Distribué lorsqu’une erreur de sécurité se produit.	BitmapImage

Détails de la propriété

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():BitmapData

bytesLoaded

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():Number

bytesTotal

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():Number

clearOnLoad

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):void

contentLoader

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):void

contentLoaderGrouping

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):void

fillMode

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):void

Eléments de l’API associés

mx.graphics.BitmapFillMode

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):void

Eléments de l’API associés

mx.graphics.BitmapFillMode
mx.graphics.BitmapScaleMode

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):void

preliminaryWidth

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):void

scaleMode

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):void

Eléments de l’API associés

mx.graphics.BitmapFillMode
mx.graphics.BitmapScaleMode

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):void

smoothingQuality

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):void

source

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):void

Eléments de l’API associés

flash.display.Bitmap
flash.display.BitmapData
mx.graphics.BitmapFill

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():Number

sourceWidth

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():Number

trustedSource

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():Boolean

verticalAlign

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):void

Eléments de l’API associés

mx.graphics.BitmapFillMode
mx.graphics.BitmapScaleMode

Détails du constructeur

()

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.

Détails de la méthode

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.

Détails de l’événement

complete

Evénement

Type d’objet d’événement: flash.events.Event
proprié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.

Pour d’autres types de source tels que les incrustations seul 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

Type d’objet d’événement: flash.events.HTTPStatusEvent
proprié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 constante HTTPStatusEvent.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

Type d’objet d’événement: flash.events.IOErrorEvent
proprié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

flash.events.IOErrorEvent

progress

Evénement

Type d’objet d’événement: flash.events.ProgressEvent
proprié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.

Définit la valeur de la propriété 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

Type d’objet d’événement: mx.events.FlexEvent
proprié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.

Pour d’autres types de source tels que les incrustations seul 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

Type d’objet d’événement: flash.events.SecurityErrorEvent
proprié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 constante SecurityErrorEvent.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

flash.events.SecurityErrorEvent

Exemples Comment utiliser cet exemple

BitmapImageExample.mxml

<?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>

Informations juridiques | Politique de confidentialité en ligne

BitmapImage - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package spark.primitives

bitmapData

bytesLoaded

bytesTotal

clearOnLoad

contentLoader

contentLoaderGrouping

fillMode

horizontalAlign

preliminaryHeight

preliminaryWidth

scaleMode

smooth

smoothingQuality

source

sourceHeight

sourceWidth

trustedSource

verticalAlign

BitmapImage

commitProperties

measure

updateDisplayList

complete

httpStatus

ioError

progress

ready

securityError