ImageElement

Package	org.osmf.elements
Classe	public class ImageElement
Héritage	ImageElement LoadableElementBase MediaElement EventDispatcher Object

Version du langage:

ActionScript 3.0

Version du produit:

OSMF 1.0

Versions du moteur d’exécution:

Flash Player 10, AIR 1.5

ImageElement est un élément multimédia créée spécialement pour présenter des images fixes. Il peut charger et présenter des images PNG, GIF ou JPG.

Les étapes élémentaires de la création et de l’utilisation d’un ImageElement sont les suivantes :

Créez un URLResource qui pointe vers l’URL de l’image à charger.
Créez l’ImageElement, en transmettant le URLResource comme paramètre.
Création d’un lecteur multimédia.
Affectez l’ImageElement à la propriété media du lecteur multimédia.
Obtenir le DisplayObject depuis la propriété displayObject du lecteur multimédia et l’ajouter à la liste d’affichage. Notez que la propriété displayObject peut ne pas être immédiatement disponible, auquel cas vous pouvez écouter l’événement du lecteur multimédia displayObjectChange.
Lorsque vous avez terminé avec l’ImageElement, définissez la propriété media du lecteur multimédia sur null et supprimez l’instance DisplayObject de la liste d’affichage.

Consulter les exemples

Eléments de l’API associés

org.osmf.elements.ImageLoader
org.osmf.media.MediaElement
org.osmf.media.MediaPlayer
org.osmf.media.URLResource

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
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		container : IMediaContainer [lecture seule] Le conteneur multimédia que cet élément utilise.	MediaElement
		metadataNamespaceURLs : Vector.<String> [lecture seule] Vecteur contenant les URL d’espace de noms de tous les objets Metadata stockés dans ce MediaElement.	MediaElement
		resource : MediaResourceBase La ressource multimédia sur laquelle cet élément multimédia fonctionne.	MediaElement
		smoothing : Boolean Indique si l’image doit être lissée lors de son redimensionnement.	ImageElement
		traitTypes : Vector.<String> [lecture seule] Un vecteur de valeurs MediaTraitType représentant les types de caractéristique sur cet élément multimédia.	MediaElement

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
		loader : LoaderBase Le LoaderBase utilisé par cet élément pour charger des ressources.	LoadableElementBase

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		ImageElement(resource:URLResource = null, loader:ImageLoader = null) Constructeur.	ImageElement
		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
		addMetadata(namespaceURL:String, metadata:Metadata):void Ajoute un objet Metadata à ce MediaElement sous l’URL d’espace de noms spécifié.	MediaElement
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getMetadata(namespaceURL:String):Metadata Renvoie l’objet Metadata qui est stocké sous ce MediaElement avec l’URL d’espace de noms indiqué.	MediaElement
		getTrait(type:String):org.osmf.traits:MediaTraitBase Renvoie le trait de support du type spécifié.	MediaElement
		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
		hasTrait(type:String):Boolean Détermine si cet élément média possède une caractéristique de média du type spécifié.	MediaElement
		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
		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
		removeMetadata(namespaceURL:String):Metadata Supprime l’objet Metadata stocké sous ce MediaElement avec l’URL d’espace de noms indiqué.	MediaElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		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
		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
		addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void Ajoute une nouvelle caractéristique commune de média à cet élément multimédia.	MediaElement
		createLoadTrait(resource:MediaResourceBase, loader:LoaderBase):org.osmf.traits:LoadTrait Les sous-classes peuvent annuler cette méthode pour renvoyer une sous-classe LoadTrait personnalisée.	LoadableElementBase
		processLoadingState():void Les sous-classes peuvent annuler cette méthode pour effectuer le traitement lorsque l’élément multimédia prend l’état LOADING.	LoadableElementBase
		processReadyState():void Les sous-classes peuvent annuler cette méthode pour effectuer le traitement lorsque l’élément multimédia prend l’état READY.	LoadableElementBase
		processUnloadingState():void Les sous-classes peuvent annuler cette méthode pour effectuer le traitement lorsque l’élément multimédia prend l’état UNLOADING.	LoadableElementBase
		removeTrait(type:String):org.osmf.traits:MediaTraitBase Supprime une nouvelle caractéristique commune de média de cet élément multimédia.	MediaElement
		setupTraits():void Définit les traits de cet élément multimédia.	MediaElement

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
containerChange	Distribué lorsque la propriété container de l’élément a été modifiée.	MediaElement
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
mediaError	Distribué lorsqu’une erreur entraînant une dégradation du fonctionnement de l’élément multimédia se produit.	MediaElement
mediaInfo	Distribué lorsque des infos ayant un impact sur le fonctionnement de l’élément multimédia sont disponibles.	MediaElement
metadataAdd	Distribué lorsqu’un objet Metadata a été ajouté à cet élément multimédia.	MediaElement
metadataRemove	Distribué lorsqu’un objet Metadata a été supprimé de cet élément multimédia.	MediaElement
traitAdd	Distribué lorsqu’une caractéristique commune est ajoutée à l’élément multimédia.	MediaElement
traitRemove	Distribué lorsqu’une caractéristique commune est supprimée de l’élément multimédia.	MediaElement

Détails de la propriété

smoothing

propriété

smoothing:Boolean

Indique si l’image doit être lissée lors de son redimensionnement. La valeur par défaut est false.

Implémentation
public function get smoothing():Boolean
public function set smoothing(value:Boolean):void

Détails du constructeur

Exemples Comment utiliser cet exemple

ImageElementExample.as

package
{
    import flash.display.Sprite;
    import flash.display.StageAlign;
    import flash.display.StageScaleMode;
    
    import org.osmf.elements.ImageElement;
    import org.osmf.elements.VideoElement;
    import org.osmf.media.MediaPlayer;
    import org.osmf.media.MediaPlayerSprite;
    import org.osmf.media.URLResource;
    
    public class ImageElementExample extends Sprite
    {
        public function ImageElementExample()
        {
            super();
            
            stage.scaleMode = StageScaleMode.NO_SCALE;
            stage.align = StageAlign.TOP_LEFT;
            
            var mediaPlayerSprite:MediaPlayerSprite = new MediaPlayerSprite();
            var imageElement:ImageElement = new ImageElement();
            imageElement.resource = new URLResource("http://mediapm.edgesuite.net/strobe/content/test/train.jpg");
            
            addChild(mediaPlayerSprite);
            mediaPlayerSprite.media = imageElement;    
        }
    }
}

Informations juridiques | Politique de confidentialité en ligne

ImageElement - AS3 OSMF

Packagesx

Eléments du langage

Annexes

Package org.osmf.elements

smoothing

	`resource:URLResource` (default = `null`) — URLResource qui pointe vers la source de l’image que l’ImageElement va utiliser.

	`loader:ImageLoader` (default = `null`) — ImageLoader utilisé pour charger l’image. Si null, l’objet ImageLoader sera créé.