ProLoader

Package	fl.display
Classe	public class ProLoader
Héritage	ProLoader Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

La classe ProLoader charge les fichiers SWF ou les images. Utilisez fl.display.ProLoader plutôt que flash.display.Loader lors du chargement des fichiers SWF générés par Flash Professional. Les membres de la classe ProLoader reflètent les membres de la classe Loader. Plutôt qu’un objet LoaderInfo, ProLoader utilise un objet ProLoaderInfo. Les membres de la classe ProLoaderInfo reflètent les membres de la classe LoaderInfo.

Remarque : ProLoader n’est pas une sous-classe de flash.display.Loader. Pour utiliser ProLoader, vous devez modifier toutes les références de type Loader à ProLoader.

ProLoader fournit une expérience de chargement homogène. Cela s’avère particulièrement utile avec les fichiers SWF qui utilisent le préchargement RSL. Par exemple, les fichiers SWF qui font appel au texte TLF utilisent le préchargement RSL par défaut. Dans ces cas, ProLoaderInfo retarde l’envoi de l’événement INIT ou COMPLETE jusqu’à ce que le préchargement RSL soit terminé et que le contenu réel soit disponible. La propriété content peut alors accéder au contenu réel. ProLoader permet également d’éviter d’autres problèmes, notamment :

Des événements addedToStage et removedFromStage supplémentaires ;
Du contenu chargé dans le mauvais parent sur l’image un (s’applique au contenu publié sur Flash Player 10.2 ou une version ultérieure à l’aide de Flash Professional CS5.5 ou une version ultérieure).

Avertissement : certains membres de ProLoader ne prennent pas en charge toutes les versions du moteur d’exécution. Accédez à ces membres uniquement lorsque vous publiez AIR ou lorsque la version de Flash Player les prend en charge. Dans le cas contraire, ces interfaces de programmation risquent de renvoyer des erreurs d’exécution. Les membres disposant d’une prise en charge limitée comprennent les méthodes et propriétés suivantes :

unloadAndStop()
loadFilePromise()
uncaughtErrorEvents

Voir la rubrique de référence pour chaque API pour vérifier la prise en charge du moteur d’exécution.

Informations complémentaires

Utilisation des classes ProLoader et ProLoaderInfo

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
		accessibilityImplementation : AccessibilityImplementation Implémentation d’accessibilité (AccessibilityImplementation) actuelle pour cette occurrence d’InteractiveObject.	InteractiveObject
		accessibilityProperties : AccessibilityProperties Options d’accessibilité actuelles de l’objet d’affichage.	DisplayObject
		alpha : Number Indique la valeur de transparence alpha de l’objet spécifié.	DisplayObject
		blendMode : String Valeur de la classe BlendMode qui spécifie le mode de fusion à utiliser.	DisplayObject
		blendShader : Shader [écriture seule] Définit un shader utilisé pour la fusion de l’arrière-plan et du premier plan.	DisplayObject
		buttonMode : Boolean Spécifie le mode de bouton du sprite.	Sprite
		cacheAsBitmap : Boolean Si la valeur true est définie, les moteurs d’exécution de Flash placent en mémoire cache une version bitmap interne de l’objet d’affichage.	DisplayObject
		cacheAsBitmapMatrix : Matrix S’il n’est pas nul, cet objet Matrix définit le mode de rendu d’un objet d’affichage lorsque cacheAsBitmap est définie sur true.	DisplayObject
		constructor : Object Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.	Object
		content : DisplayObject [lecture seule] Contient l’objet d’affichage racine du fichier SWF ou du fichier d’image (JPG, PNG ou GIF) qui a été chargé à l’aide de la méthode load() ou loadBytes().	ProLoader
		contentLoaderInfo : ProLoaderInfo [lecture seule] Renvoie un objet ProLoaderInfo qui correspond à l’objet en cours de chargement.	ProLoader
		contextMenu : NativeMenu Spécifie le menu contextuel associé à l’objet.	InteractiveObject
		doubleClickEnabled : Boolean Spécifie si l’objet reçoit les événements doubleClick.	InteractiveObject
		dropTarget : DisplayObject [lecture seule] Spécifie l’objet d’affichage sur lequel le sprite est glissé ou sur lequel il a été déposé.	Sprite
		filters : Array Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage.	DisplayObject
		focusRect : Object Spécifie si l’objet affiche un rectangle de focus.	InteractiveObject
		graphics : Graphics [lecture seule] Spécifie l’objet Graphics appartenant au sprite qui prend en charge les commandes de dessin vectoriel.	Sprite
		height : Number Indique la hauteur de l’objet d’affichage, en pixels.	DisplayObject
		hitArea : Sprite Désigne un autre sprite qui fera office de zone active d’un sprite.	Sprite
		loaderInfo : LoaderInfo [lecture seule] Renvoie un objet LoaderInfo qui contient des informations relatives au chargement du fichier auquel appartient cet objet d’affichage.	DisplayObject
		mask : DisplayObject L’objet d’affichage appelant est masqué par l’objet mask spécifié.	DisplayObject
		metaData : Object Obtient les données d’objet de métadonnées de l’occurrence DisplayObject si les données d’meta a été stockée près de la l’occurrence de cette DisplayObject dans le fichier SWF à l’aide d’une balise de4 PlaceObject.	DisplayObject
		mouseChildren : Boolean Détermine si les enfants de l’objet prennent en charge la souris ou les périphériques de saisie utilisateur.	DisplayObjectContainer
		mouseEnabled : Boolean Spécifie si l’objet reçoit des messages de la souris ou d’un autre périphérique de saisie utilisateur.	InteractiveObject
		mouseX : Number [lecture seule] Indique la coordonnée x de la souris ou ou la position du périphérique de saisie utilisateur, en pixels.	DisplayObject
		mouseY : Number [lecture seule] Indique la coordonnée y de la souris ou la position du périphérique de saisie utilisateur, en pixels.	DisplayObject
		name : String Indique le nom d’occurrence de DisplayObject.	DisplayObject
		needsSoftKeyboard : Boolean Indique si un clavier virtuel (clavier logiciel à l’écran) doit s’afficher lorsque cette occurrence d’InteractiveObject reçoit le focus.	InteractiveObject
		numChildren : int [lecture seule] Renvoie le nombre d’enfants de l’objet.	DisplayObjectContainer
		opaqueBackground : Object Indique si l’objet d’affichage est opaque avec une couleur d’arrière-plan spécifique.	DisplayObject
		parent : DisplayObjectContainer [lecture seule] Indique l’objet DisplayObjectContainer qui contient l’objet d’affichage.	DisplayObject
		root : DisplayObject [lecture seule] Pour un objet d’affichage résidant dans un fichier SWF chargé, la propriété root correspond à l’objet d’affichage de premier niveau dans la partie de la structure arborescente de la liste d’affichage représentée par ce fichier.	DisplayObject
		rotation : Number Indique la rotation de l’occurrence de DisplayObject, en degrés, à partir de son orientation d’origine.	DisplayObject
		rotationX : Number Indique la rotation de l’axe des x de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.	DisplayObject
		rotationY : Number Indique la rotation de l’axe des y de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.	DisplayObject
		rotationZ : Number Indique la rotation de l’axe des z de l’occurrence DisplayObject, en degrés, à partir de son orientation d’origine par rapport au conteneur 3D parent.	DisplayObject
		scale9Grid : Rectangle Grille de mise à l’échelle en vigueur.	DisplayObject
		scaleX : Number Indique l’échelle horizontale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement.	DisplayObject
		scaleY : Number Indique l’échelle verticale (pourcentage) de l’objet telle qu’elle est appliquée à partir du point d’alignement.	DisplayObject
		scaleZ : Number Indique l’échelle de profondeur (pourcentage) de l’objet tel qu’elle est appliquée à partir du point d’alignement.	DisplayObject
		scrollRect : Rectangle Cadre de sélection du défilement de l’objet d’affichage.	DisplayObject
		softKeyboard : String Contrôle l’aspect du clavier logiciel.	InteractiveObject
		softKeyboardInputAreaOfInterest : Rectangle Définit la zone qui doit rester à l’écran lorsqu’un clavier logiciel s’affiche (non disponible sur iOS)	InteractiveObject
		soundTransform : flash.media:SoundTransform Contrôle le son à l’intérieur du sprite.	Sprite
		stage : Stage [lecture seule] Scène de l’objet d’affichage.	DisplayObject
		tabChildren : Boolean Détermine si les enfants de l’objet prennent ou non en charge la tabulation.	DisplayObjectContainer
		tabEnabled : Boolean Indique si cet objet est spécifié dans l’ordre de tabulation.	InteractiveObject
		tabIndex : int Spécifie l’ordre de tabulation des objets dans un fichier SWF.	InteractiveObject
		textSnapshot : flash.text:TextSnapshot [lecture seule] Renvoie un objet TextSnapshot pour l’occurrence de DisplayObjectContainer.	DisplayObjectContainer
		transform : flash.geom:Transform Objet dont les propriétés se rapportent à la matrice, à la transformation des couleurs et aux limites des pixels d’un objet d’affichage.	DisplayObject
		uncaughtErrorEvents : EventDispatcher [lecture seule] Objet qui distribue un événement uncaughtError lorsqu’une erreur non interceptée se produit dans le code du fichier SWF de cet objet ProLoader.	ProLoader
		useHandCursor : Boolean Valeur booléenne indiquant si le curseur en forme de main apparaît lorsque le pointeur survole un sprite dont la propriété buttonMode est définie sur true.	Sprite
		visible : Boolean Indique si l’objet d’affichage est visible ou non.	DisplayObject
		width : Number Indique la largeur de l’objet d’affichage, en pixels.	DisplayObject
		x : Number Indique la coordonnée x de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.	DisplayObject
		y : Number Indique la coordonnée y de l’occurrence de DisplayObject par rapport aux coordonnées locales de l’objet DisplayObjectContainer parent.	DisplayObject
		z : Number Indique la position de coordonnée z le long de l’axe des z de l’occurrence DisplayObject par rapport au conteneur 3D parent.	DisplayObject

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		ProLoader() Crée un objet ProLoader qui permet de charger des fichiers (SWF, JPEG, GIF ou PNG).	ProLoader
		addChild(child:DisplayObject):DisplayObject Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject Ajoute une occurrence DisplayObject enfant à cette occurrence DisplayObjectContainer.	DisplayObjectContainer
		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
		areInaccessibleObjectsUnderPoint(point:Point):Boolean Indique si les restrictions de sécurité entraîneraient l’omission des objets d’affichage de la liste renvoyée en appelant la méthode DisplayObjectContainer.getObjectsUnderPoint() avec le point « point » spécifié.	DisplayObjectContainer
		close():void Annule une opération associée à la méthode load() actuellement en cours d’exécution pour l’occurrence de ProLoader.	ProLoader
		contains(child:DisplayObject):Boolean Détermine si l’objet d’affichage spécifié est un enfant de l’occurrence de DisplayObjectContainer ou l’occurrence en tant que telle.	DisplayObjectContainer
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Renvoie un rectangle qui définit la zone de l’objet d’affichage relativement au système de coordonnées de l’objet targetCoordinateSpace.	DisplayObject
		getChildAt(index:int):DisplayObject Renvoie l’occurrence enfant de l’objet d’affichage associée à l’index spécifié.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Renvoie l’objet d’affichage enfant portant le nom spécifié.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Renvoie la position d’index d’une occurrence enfant de DisplayObject.	DisplayObjectContainer
		getObjectsUnderPoint(point:Point):Array Renvoie un tableau d’objets de niveau inférieur au point spécifié et qui sont les enfants (ou les petits-enfants, etc.) de l’occurrence de DisplayObjectContainer.	DisplayObjectContainer
		getRect(targetCoordinateSpace:DisplayObject):Rectangle Renvoie un rectangle qui définit les limites de l’objet d’affichage, en se basant sur le système de coordonnées défini par le paramètre targetCoordinateSpace, moins tout trait appliqué aux formes.	DisplayObject
		globalToLocal(point:Point):Point Convertit l’objet point des coordonnées de scène (globales) vers les coordonnées de l’objet d’affichage (locales).	DisplayObject
		globalToLocal3D(point:Point):Vector3D Convertit un point bidimensionnel à partir des coordonnées de scène (globales) vers les coordonnées d’un objet d’affichage tridimensionnel (locales).	DisplayObject
		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
		hitTestObject(obj:DisplayObject):Boolean Evalue le cadre de sélection de l’objet d’affichage pour savoir s’il recouvre ou recoupe le cadre de sélection de l’objet d’affichage obj.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Evalue l’objet d’affichage pour savoir s’il recouvre ou recoupe le point spécifié par les paramètres x et y.	DisplayObject
		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
		load(request:URLRequest, context:LoaderContext = null):void Charge un fichier SWF, JPEG, JPEG progressif, GIF non animé ou PNG dans un objet enfant de l’objet ProLoader.	ProLoader
		loadBytes(bytes:ByteArray, context:LoaderContext = null):void Charge des données binaires stockées dans un objet ByteArray.	ProLoader
		loadFilePromise(promise:Object, context:LoaderContext = null):void Charge une occurrence d’IFilePromise par le biais du paramètre promise.	ProLoader
		local3DToGlobal(point3d:Vector3D):Point Convertit un point tridimensionnel des coordonnées de l’objet d’affichage tridimensionnel (locales) vers un point bidimensionnel dans les coordonnées de scène (globales).	DisplayObject
		localToGlobal(point:Point):Point Convertit l’objet point des coordonnées de l’objet d’affichage (locales) vers les coordonnées de la scène (globales).	DisplayObject
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeChild(child:DisplayObject):DisplayObject Supprime l’occurrence enfant de DisplayObject spécifiée de la liste d’enfants de l’occurrence de DisplayObjectContainer.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Supprime une occurrence enfant de DisplayObject de la position d’index spécifiée dans la liste d’enfants de DisplayObjectContainer.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Supprime toutes les occurrences enfants de DisplayObject de la liste d’enfants de l’occurrence de DisplayObjectContainer.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	EventDispatcher
		requestSoftKeyboard():Boolean Affiche un clavier virtuel.	InteractiveObject
		setChildIndex(child:DisplayObject, index:int):void Modifie la position d’un enfant existant dans le conteneur d’objet d’affichage.	DisplayObjectContainer
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Permet à l’utilisateur de faire glisser le sprite spécifié.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Permet à l’utilisateur de faire glisser le sprite spécifié sur un périphérique tactile.	Sprite
		stopAllMovieClips():void Interrompt de façon récursive l’exécution du scénario de tous les clips ayant cet objet comme racine.	DisplayObjectContainer
		stopDrag():void Met fin à la méthode startDrag().	Sprite
		stopTouchDrag(touchPointID:int):void Met fin à la méthode startTouchDrag() en vue d’utiliser des périphériques tactiles.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des deux objets enfant spécifiés.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void Intervertit l’ordre de plan (ordre d’empilement du premier plan vers l’arrière-plan) des objets enfant aux deux positions d’index spécifiées dans la liste d’enfants.	DisplayObjectContainer
		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
		unload():void Supprime un enfant de l’objet ProLoader chargé à l’aide de la méthode load().	ProLoader
		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

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
added	Distribué lorsqu’un objet d’affichage est ajouté à la liste d’affichage.	DisplayObject
addedToStage	Envoyé lorsqu’un objet d’affichage est ajouté dans la liste d’affichage de la scène, directement ou par l’intermédiaire d’une arborescence secondaire qui contient l’objet d’affichage.	DisplayObject
clear	Distribué lorsque l’utilisateur sélectionne ’Effacer’ (ou ’Supprimer’) dans le menu contextuel.	InteractiveObject
click	Distribué lorsque l’utilisateur appuie sur le bouton principal de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.	InteractiveObject
contextMenu	Distribué lorsque l’action d’un utilisateur active le menu contextuel associé à cet objet interactif dans une application AIR.	InteractiveObject
copy	Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de copie ou sélectionne "Copier" dans le menu contextuel.	InteractiveObject
cut	Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de coupage ou sélectionne "Couper" dans le menu contextuel.	InteractiveObject
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
doubleClick	Distribué lorsque l’utilisateur appuie sur le bouton principal d’un périphérique de pointage et le relâche deux fois de suite sur la même occurrence d’InteractiveObject si l’indicateur doubleClickEnabled de cet objet est réglé sur true.	InteractiveObject
enterFrame	[événement de diffusion] Distribué lorsque la tête de lecture est placée sur une nouvelle image.	DisplayObject
exitFrame	[événement de diffusion] Distribué lorsque la tête de lecture quitte l’image en cours.	DisplayObject
focusIn	Distribué après la prise de focus par un objet d’affichage.	InteractiveObject
focusOut	Distribué après la perte de focus par un objet d’affichage.	InteractiveObject
frameConstructed	[événement de diffusion] Distribué après l’exécution des constructeurs des objets d’affichage d’image, mais avant celle des scripts d’image.	DisplayObject
gestureDirectionalTap	Distribué lorsque l’utilisateur crée un point de contact le long du bord de la surface tactile à l’aide d’une occurrence InteractiveObject (par exemple, en appuyant le long du bord de la surface tactile sur la télécommande Siri Remote pour l’Apple TV). Certains périphériques peuvent également interpréter ce contact comme une combinaison de plusieurs événements tactiles.	InteractiveObject
gestureLongPress	Distribué lorsque l’utilisateur appuie sur deux points de contact sur la même occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsque l’utilisateur appuie avec deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les retire).	InteractiveObject
gesturePan	Distribué lorsque l’utilisateur déplace un point de contact sur l’occurrence d’InteractiveObject d’un périphérique tactile (notamment lorsqu’il déplace un doigt de gauche à droite sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).	InteractiveObject
gestureRotate	Distribué lorsque l’utilisateur effectue un mouvement de rotation sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis les fait pivoter).	InteractiveObject
gestureSwipe	Distribué lorsque l’utilisateur effectue un mouvement de glissement sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose trois doigts puis les déplace parallèlement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).	InteractiveObject
gestureTap	Distribué lorsque l’utilisateur crée un point de contact à l’aide d’une occurrence d’InteractiveObject, puis appuie brièvement sur un périphérique tactile (notamment lorsqu’il place plusieurs doigts sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile pour ouvrir un menu, puis appuie brièvement avec un doigt pour sélectionner une option de menu).	InteractiveObject
gestureZoom	Distribué lorsque l’utilisateur effectue un mouvement de zoom sur un point de contact à l’aide d’une occurrence d’InteractiveObject (par exemple, lorsqu’il pose deux doigts, puis les écarte rapidement sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).	InteractiveObject
imeStartComposition	Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.	InteractiveObject
keyDown	Distribué lorsque l’utilisateur appuie sur une touche.	InteractiveObject
keyFocusChange	Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide du clavier.	InteractiveObject
keyUp	Distribué lorsque l’utilisateur relâche une touche.	InteractiveObject
middleClick	Distribué lorsque l’utilisateur appuie sur le bouton central de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.	InteractiveObject
middleMouseDown	Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage central sur une occurrence InteractiveObject.	InteractiveObject
middleMouseUp	Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
mouseDown	Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
mouseFocusChange	Distribué lorsque l’utilisateur tente de déplacer le focus à l’aide d’un périphérique de pointage.	InteractiveObject
mouseMove	Distribué lorsque l’utilisateur déplace le périphérique de pointage placé sur une occurrence de InteractiveObject.	InteractiveObject
mouseOut	Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject.	InteractiveObject
mouseOver	Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.	InteractiveObject
mouseUp	Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
mouseWheel	Distribué lorsque la molette d’une souris est actionnée sur une occurrence de InteractiveObject.	InteractiveObject
nativeDragComplete	Distribué par l’initiateur glisser InteractiveObject lorsque l’utilisateur arrête l’opération glisser.	InteractiveObject
nativeDragDrop	Distribué par l’objet InteractiveObject cible lorsqu’un objet glissé est déposé dessus et que l’opération déposer a été acceptée avec un appel à DragManager.acceptDragDrop().	InteractiveObject
nativeDragEnter	Distribué par un InteractiveObject lorsqu’une opération glisser entre dans ses limites.	InteractiveObject
nativeDragExit	Distribué par un InteractiveObject lorsqu’une opération glisser sort des limites.	InteractiveObject
nativeDragOver	Distribué par un objet InteractiveObject de façon continue lorsqu’une opération glisser reste dans ses limites.	InteractiveObject
nativeDragStart	Distribué au début d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().	InteractiveObject
nativeDragUpdate	Distribué lors d’une opération glisser par l’objet InteractiveObject spécifié comme initiateur de l’action glisser dans l’appel DragManager.doDrag().	InteractiveObject
paste	Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour une opération de collage ou sélectionne "Coller" dans le menu contextuel.	InteractiveObject
proximityBegin	Distribué lorsque l’utilisateur approche un stylet actif de l’écran après le seuil de détection de proximité de l’écran.	InteractiveObject
proximityEnd	Distribué lorsque l’utilisateur soulève un stylet actif au-dessus du seuil de détection de proximité de l’écran.	InteractiveObject
proximityMove	Distribué lorsque l’utilisateur déplace un stylet actif sur l’écran tout en respectant le seuil de détection de proximité.	InteractiveObject
proximityOut	Distribué lorsque l’utilisateur déplace un stylet actif en dehors de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran.	InteractiveObject
proximityOver	Distribué lorsque l’utilisateur déplace un stylet actif directement au-dessus de cet objet InteractiveObject, tout en respectant le seuil de détection de proximité de l’écran.	InteractiveObject
proximityRollOut	Distribué lorsque l’utilisateur déplace un stylet actif hors de cet objet InteractiveObject et de l’un de ses enfants, tout en respectant le seuil de détection de proximité de l’écran.	InteractiveObject
proximityRollOver	Distribué lorsque l’utilisateur déplace un stylet actif sur cet objet InteractiveObject de l’extérieur de l’arborescence d’objets de descendants dans la liste d’affichage (tout en respectant le seuil de détection de proximité de l’écran).	InteractiveObject
releaseOutside	Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage après avoir appuyé sur le bouton sur une occurrence d’InteractiveObject, puis après avoir déplacé le périphérique de pointage hors de l’occurrence d’InteractiveObject.	InteractiveObject
removed	Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage.	DisplayObject
removedFromStage	Distribué lorsqu’un objet d’affichage est sur le point d’être supprimé de la liste d’affichage de la scène, directement ou par l’intermédiaire de la suppression d’une arborescence secondaire qui contient l’objet d’affichage.	DisplayObject
render	[événement de diffusion] Distribué lorsque la liste d’affichage est sur le point d’être mise à jour et restituée.	DisplayObject
rightClick	Distribué lorsque l’utilisateur appuie sur le bouton droit de son périphérique de pointage et le relâche sur la même occurrence de InteractiveObject.	InteractiveObject
rightMouseDown	Distribué lorsqu’un utilisateur appuie sur le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
rightMouseUp	Distribué lorsqu’un utilisateur relâche le bouton du périphérique de pointage sur une occurrence InteractiveObject.	InteractiveObject
rollOut	Distribué lorsque l’utilisateur éloigne un périphérique de pointage d’une occurrence de InteractiveObject.	InteractiveObject
rollOver	Distribué lorsque l’utilisateur place un périphérique de pointage sur une occurrence de InteractiveObject.	InteractiveObject
selectAll	Distribué lorsque l’utilisateur active la combinaison de touches de raccourci propre à la plate-forme pour tout sélectionner ou choisit "Sélectionner tout" dans le menu contextuel.	InteractiveObject
softKeyboardActivate	Distribué immédiatement après l’affichage du clavier logiciel.	InteractiveObject
softKeyboardActivating	Distribué immédiatement avant l’affichage du clavier logiciel.	InteractiveObject
softKeyboardDeactivate	Distribué immédiatement après la disparition du clavier logiciel.	InteractiveObject
tabChildrenChange	Distribué lorsque la valeur de l’indicateur tabChildren de l’objet change.	InteractiveObject
tabEnabledChange	Distribué lorsque l’indicateur tabEnabled de l’objet change.	InteractiveObject
tabIndexChange	Distribué lorsque la valeur de la propriété tabIndex de l’objet change.	InteractiveObject
textInput	Distribué lorsqu’un utilisateur entre un ou plusieurs caractères de texte.	InteractiveObject
touchBegin	Distribué lorsque l’utilisateur touche pour la première fois un périphérique tactile (notamment lorsqu’il pose un doigt sur un téléphone portable ou une tablette munis d’un écran tactile).	InteractiveObject
touchEnd	Distribué lorsque l’utilisateur cesse le contact avec un périphérique tactile (notamment lorsqu’il retire le doigt d’un téléphone portable ou d’une tablette munis d’un écran tactile).	InteractiveObject
touchMove	Distribué lorsque l’utilisateur appuie sur le périphérique, et est continuellement distribué jusqu’au retrait du point de contact.	InteractiveObject
touchOut	Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un objet d’affichage vers un autre sur un téléphone portable ou une tablette munis d’un écran tactile).	InteractiveObject
touchOver	Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).	InteractiveObject
touchRollOut	Distribué lorsque l’utilisateur retire le point de contact d’une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un se trouvant sur l’objet d’affichage d’un téléphone portable ou une tablette munis d’un écran tactile vers un point se trouvant en dehors de cet objet).	InteractiveObject
touchRollOver	Distribué lorsque l’utilisateur déplace le point de contact sur une occurrence d’InteractiveObject sur un périphérique tactile (notamment lorsqu’il fait glisser un doigt d’un point se trouvant en dehors d’un objet d’affichage vers un point sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile).	InteractiveObject
touchTap	Distribué lorsque l’utilisateur lève le point de contact sur la même occurrence d’InteractiveObject sur laquelle le contact a été lancé sur un périphérique tactile (notamment lorsqu’il appuie avec un doigt à partir d’un point de contact unique sur l’objet d’affichage d’un téléphone portable ou d’une tablette munis d’un écran tactile, puis le retire).	InteractiveObject

Détails de la propriété

content

propriété

content:DisplayObject [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

Contient l’objet d’affichage racine du fichier SWF ou du fichier d’image (JPG, PNG ou GIF) qui a été chargé à l’aide de la méthode load() ou loadBytes().

Implémentation
public function get content():DisplayObject

Valeur émise

SecurityError — Le fichier SWF ou le fichier d’image chargé appartient à un sandbox de sécurité auquel vous n’avez pas accès. Pour un fichier SWF chargé, vous pouvez éviter ce problème en forçant le fichier à appeler la méthode Security.allowDomain() ou en imposant au fichier en cours de chargement de spécifier un paramètre loaderContext, la propriété securityDomain correspondante étant réglée sur SecurityDomain.currentDomain lorsque vous appelez la méthode load() ou loadBytes().

contentLoaderInfo

propriété

contentLoaderInfo:ProLoaderInfo [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

Renvoie un objet ProLoaderInfo qui correspond à l’objet en cours de chargement. Les objets ProLoaderInfo sont partagés entre l’objet ProLoader et l’objet chargé. L’objet ProLoaderInfo fournit des informations relatives à la progression du déroulement du chargement et des statistiques sur le fichier chargé.

Les événements liés au chargement sont distribués par l’objet ProLoaderInfo qui est référencé par la propriété contentLoaderInfo de l’objet ProLoader. La propriété contentLoaderInfo est définie sur un objet ProLoaderInfo valide, y compris avant le chargement du contenu, ce qui permet d’ajouter des écouteurs d’événement à l’objet avant l’opération de chargement.

Pour détecter les erreurs non interceptées qui se produisent dans un fichier SWF, utilisez la propriété ProLoader.uncaughtErrorEvents et non la propriété ProLoader.contentLoaderInfo.uncaughtErrorEvents.

Remarque : la propriété contentLoaderInfo renvoie un objet ProLoaderInfo. ProLoaderInfo n’est pas une sous-classe de LoaderInfo et ne donne par conséquent pas l’avantage d’une distribution implicite à la superclasse. Par conséquent, n’oubliez pas de modifier vos déclarations de type de LoaderInfo à ProLoaderInfo.

Implémentation
public function get contentLoaderInfo():ProLoaderInfo

uncaughtErrorEvents

propriété

uncaughtErrorEvents:EventDispatcher [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

Flash Player 10.1, AIR 2.0

Objet qui distribue un événement uncaughtError lorsqu’une erreur non interceptée se produit dans le code du fichier SWF de cet objet ProLoader. Une erreur non interceptée se produit lorsqu’une erreur est renvoyée en dehors de tout bloc try..catch ou lorsqu’un objet ErrorEvent est distribué avec aucun écouteur enregistré.

Cette propriété est créée à la fin du chargement du fichier SWF associé à cet objet ProLoader. Tant que la propriété uncaughtErrorEvents n’est pas définie sur null, Dans un projet ActionScript uniquement, vous pouvez accéder à cette propriété pendant ou après l’exécution de la fonction constructeur de la classe principale du fichier SWF.

L’accès à cette propriété ProLoader dans un lecteur qui ne la prend pas en charge entraîne une erreur. Renvoie un objet EventDispatcher au lieu d’un objet UncaughtErrorEvents pour éviter de générer des erreurs dans les lecteurs non pris en charge.

Implémentation
public function get uncaughtErrorEvents():EventDispatcher

Eléments de l’API associés

flash.display.LoaderInfo.uncaughtErrorEvents

Détails du constructeur

()

Constructeur

public function ProLoader()

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

Crée un objet ProLoader qui permet de charger des fichiers (SWF, JPEG, GIF ou PNG). Appelez la méthode load() pour charger la ressource en tant qu’enfant de l’occurrence de ProLoader. Vous pouvez alors ajouter l’objet ProLoader à la liste d’affichage (notamment par le biais de la méthode addChild() d’une occurrence de DisplayObjectContainer). L’actif apparaît sur la scène au fur et à mesure de son chargement.

Vous pouvez également utiliser une occurrence de ProLoader sans l’intégrer à un conteneur d’objet d’affichage de la liste d’affichage. Si ce mode est activé, l’occurrence de Loader peut être utilisée pour charger un fichier SWF contenant d’autres modules d’une application.

Pour détecter la fin du chargement du fichier SWF, vous disposez des événements de l’objet ProLoaderInfo associés à la propriété contentLoaderInfo de l’objet ProLoader. A ce stade, vous pouvez exécuter le code du fichier SWF du module pour initialiser et démarrer ce dernier. En mode hors liste, l’occurrence de ProLoader peut également être utilisée pour charger un fichier SWF contenant des composants ou des actifs multimédias. Il est également possible d’utiliser les notifications d’événement associées à l’objet ProLoaderInfo pour détecter la fin du chargement des composants. L’application peut alors commencer à utiliser les composants et les actifs multimédias intégrés à la bibliothèque du fichier SWF en instanciant les classes ActionScript 3.0 qui représentent ces composants et ces actifs.

Pour déterminer le statut d’un objet ProLoader, supervisez les événements suivants que l’objet ProLoaderInfo a associé à la propriété contentLoaderInfo de l’objet ProLoader :

L’événement open est distribué lorsque le chargement commence.
L’événement ioError ou securityError est distribué s’il est impossible de charger le fichier ou s’il se produit une erreur lors du processus de chargement.
L’événement progress est déclenché continuellement lors du chargement du fichier.
L’événement complete est distribué lorsque le chargement d’un fichier est terminé, mais avant la mise à disposition des méthodes et des propriétés du clip qui vient d’être chargé. Si le fichier SWF chargé utilise le préchargement RSL, cet événement est distribué à la fin du préchargement RSL. A ce stade, le contenu réel est disponible dans la propriété content.
L’événement init est distribué après la mise à disposition des méthodes et des propriétés du fichier SWF chargé, afin de vous permettre de commencer à manipuler ce dernier. Cet événement est distribué avant le gestionnaire complete. Dans les fichiers SWF en diffusion continue, l’événement init risque de se produire bien avant l’événement complete. Dans la plupart des cas, utilisez le gestionnaire init. Si le fichier SWF chargé utilise le préchargement RSL, cet événement est distribué à la fin du préchargement RSL. A ce stade, le contenu réel est disponible dans la propriété content.

Eléments de l’API associés

fl.display.ProLoader.load()
fl.display.ProLoaderInfo

Détails de la méthode

close

()

méthode

public function close():void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

AIR 1.0, Flash Player Player - 9

Annule une opération associée à la méthode load() qui est en cours d’exécution pour l’occurrence de ProLoader.

load

()

méthode

public function load(request:URLRequest, context:LoaderContext = null):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

Flash Player 9, AIR 1.0, Flash Player Player - 9

Charge un fichier SWF, JPEG, JPEG progressif, GIF non animé ou PNG dans un objet enfant de l’objet ProLoader. Si vous chargez un fichier GIF animé, seule la première image est affichée. Puisque l’objet ProLoader ne peut contenir qu’un seul enfant, générer une nouvelle requête load() met fin à la requête précédente si elle est en attente et démarre un autre chargement.

Remarque : dans AIR 1.5 et Flash Player 10, la taille maximale d’une image chargée est de 8 191 pixels en largeur ou en hauteur, et le nombre total de pixels ne peut pas excéder 16 777 215 pixels (ainsi, si la largeur d’une image chargée est de 8 191 pixels, sa hauteur maximale doit être de 2 048 pixels). Dans Flash Player 9 et les versions antérieures, ainsi que dans AIR 1.1 et les versions antérieures, la limite est de 2 880 pixels de haut sur 2 880 pixels de large.

Un fichier SWF ou une image chargé(e) dans un objet ProLoader hérite des propriétés position, rotation et scale (échelle) des objets d’affichage parents de l’objet ProLoader.

Utilisez unload() pour supprimer des animations ou des images chargées à l’aide de cette méthode ou pour annuler une opération de chargement en cours.

Vous pouvez empêcher un fichier SWF d’utiliser cette méthode en définissant le paramètre allowNetworking des balises object et embed dans la page HTML qui comporte le contenu SWF.

Si vous utilisez cette méthode, tenez compte du modèle de sécurité de Flash Player, expliqué dans la description de la classe ProLoader.

Dans Flash Player versions 10 et ultérieures, si vous utilisez un Content-Type en plusieurs parties (par exemple « multipart/form-data ») qui contient un chargement (indiqué par un paramètre « filename » dans un en-tête « content-disposition » au sein du corps POST), l’opération POST est soumise aux règles de sécurité appliquées aux chargements :

L’opération POST doit être effectuée en réponse à l’action d’un utilisateur, comme un clic de souris ou la pression d’une touche.
Si l’opération POST se fait entre plusieurs domaines (la cible POST ne se trouve pas sur le même serveur que le fichier SWF qui envoie la demande POST), le serveur cible doit fournir un fichier de régulation d’URL qui permette l’accès interdomaines.

Par ailleurs, la syntaxe de tous les Content-Type en plusieurs parties doit être correcte (selon la norme RFC2046). Si la syntaxe s’avère incorrecte, l’opération POST est soumise aux règles de sécurité appliquées aux chargements.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Paramètres

request:URLRequest — URL absolue ou relative du fichier SWF, JPEG, GIF ou PNG à charger. Un chemin relatif doit être relatif par rapport au fichier SWF principal. Une URL absolue doit inclure la référence de protocole, telle que http:// ou file:///. Les noms de fichier ne doivent pas inclure les spécifications de lecteur de disque.

context:LoaderContext (default = null) — Objet LoaderContext, dont les propriétés :

Spécifie si l’existence d’un fichier de régulation lors du chargement de l’objet doit être vérifiée ou non
définissent le paramètre ApplicationDomain de l’objet chargé ;
définissent le paramètre SecurityDomain de l’objet chargé.
ImageDecodingPolicy correspondant à l’objet image chargé.

Si le paramètre context n’est pas spécifié ou renvoie à un objet null, le contenu chargé reste dans son propre domaine de sécurité.

Pour obtenir des informations détaillées, veuillez consulter la description des propriétés de la classe LoaderContext.

Evénements

	`asyncError:AsyncErrorEvent` — Distribué par l’objet `contentLoaderInfo` si la propriété `LoaderContext.requestedContentParent` a été spécifiée et qu’il est impossible d’ajouter le contenu chargé en tant qu’enfant au DisplayObjectContainer spécifié. C’est notamment le cas si le contenu chargé est un `flash.display.AVM1Movie` ou si l’appel de `addChild()` sur requestedContentParent renvoie une erreur.

	`complete:Event` — Distribué par l’objet `contentLoaderInfo` associé lorsque le fichier a terminé son chargement. L’événement `complete` est toujours distribué après l’événement `init`.

	`httpStatus:HTTPStatusEvent` — Distribué par l’objet `contentLoaderInfo` associé lorsqu’une requête réseau est envoyée via HTTP et que Flash Player peut détecter le code d’état HTTP.

	`init:Event` — Distribué par l’objet `contentLoaderInfo` associé lorsque les propriétés et les méthodes du fichier SWF chargé sont accessibles. L’événement `init` précède toujours l’événement `complete`.

	`ioError:IOErrorEvent` — Distribué par l’objet `contentLoaderInfo` associé lorsqu’il se produit une erreur d’entrée ou de sortie entraînant l’échec d’une opération de chargement.

	`open:Event` — Distribué par l’objet `contentLoaderInfo` associé lorsque l’opération de chargement commence.

	`progress:ProgressEvent` — Distribué par l’objet `contentLoaderInfo` associé en tant que données et reçu pendant la progression de l’opération de chargement.

	`securityError:SecurityErrorEvent` — Distribué par l’objet `contentLoaderInfo` si un fichier SWF du sandbox local avec système de fichiers tente de charger du contenu dans un sandbox local avec accès au réseau, ou vice versa.

	`securityError:SecurityErrorEvent` — Distribué par l’objet `contentLoaderInfo` si la propriété `LoaderContext.requestedContentParent` a été spécifiée et que le sandbox de sécurité du `LoaderContext.requestedContentParent` n’a pas accès au fichier SWF chargé.

	`unload:Event` — Distribué par l’objet `contentLoaderInfo` associé lorsqu’un objet chargé est supprimé.

Valeur émise

	`IOError` — La propriété `digest` de l’objet `request` n’est pas définie sur `null`. Vous devez définir la propriété `digest` d’un objet URLRequest uniquement lorsque vous appelez la méthode `URLLoader.load()` en vue de charger un fichier SWZ (un composant de la plateforme Adobe).

	`SecurityError` — La valeur de `LoaderContext.securityDomain` doit être réglée sur `null` ou `SecurityDomain.currentDomain`. En effet, vous ne pouvez placer le média chargé que dans son sandbox de sécurité naturel ou dans le vôtre, auquel cas l’utilisation d’un fichier de régulation s’impose.

	`SecurityError` — Les fichiers SWF locaux sont susceptibles de ne régler LoaderContext.securityDomain que sur la valeur `null`. Il est interdit d’importer des médias non locaux dans un sandbox local ou de placer d’autres médias locaux dans un environnement autre que son sandbox naturel.

	`SecurityError` — Vous ne pouvez pas vous connecter aux ports généralement réservés. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.

	`SecurityError` — Si les propriétés `applicationDomain` or `securityDomain` du paramètre `context` proviennent d’un domaine interdit.

	`SecurityError` — Si un fichier SWF local tente d’utiliser la propriété `securityDomain` du paramètre `context`.

	`IllegalOperationError` — Si la propriété `requestedContentParent` du paramètre `context` est un objet `ProLoader`.

	`IllegalOperationError` — Si le paramètre `LoaderContext.parameters` est défini sur une valeur non nulle et possède certaines valeurs qui ne sont pas des chaînes.

Eléments de l’API associés

contentLoaderInfo
flash.net.URLRequest
flash.display.DisplayObject
fl.display.ProLoader.unload()
fl.display.ProLoaderInfo
flash.system.LoaderContext

loadBytes

()

méthode

public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

Flash Player 9, AIR 1.0, Flash Player 9

Charge des données binaires stockées dans un objet ByteArray.

La méthode loadBytes() est asynchrone. Vous devez attendre l’événement « init » avant d’accéder aux propriétés d’un objet chargé.

Si vous utilisez cette méthode, tenez compte du modèle de sécurité de Flash Player, expliqué dans la description de la classe ProLoader.

Paramètres

bytes:ByteArray — Objet ByteArray. Le format du contenu de cet objet peut correspondre à n’importe quel type de fichier géré par la classe ProLoader : SWF, GIF, JPEG ou PNG.

context:LoaderContext (default = null) — Objet LoaderContext. Seule la propriété applicationDomain de cet objet entre en vigueur. Les propriétés checkPolicyFile et securityDomain sont exclues.

Si le paramètre context n’est pas spécifié ou renvoie à un objet null, le contenu est chargé dans le domaine de sécurité actif ; cette opération est appelée « chargement en vue de l’exportation » dans la documentation de sécurité de Flash Player. De façon spécifique, si le fichier SWF de chargement approuve le fichier SWF distant en l’incorporant dans son code, le fichier SWF de chargement peut l’importer directement dans son propre domaine de sécurité.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Evénements

	`asyncError:AsyncErrorEvent` — Distribué par l’objet `contentLoaderInfo` si la propriété `LoaderContext.requestedContentParent` a été spécifiée et qu’il est impossible d’ajouter le contenu chargé en tant qu’enfant au DisplayObjectContainer spécifié. C’est notamment le cas si le contenu chargé est un `flash.display.AVM1Movie` ou si l’appel de `addChild()` sur requestedContentParent renvoie une erreur.

	`complete:Event` — Distribué par l’objet `contentLoaderInfo` lorsque l’opération est terminée. L’événement `complete` est toujours distribué après l’événement `init`.

	`init:Event` — Distribué par l’objet `contentLoaderInfo` lorsque les propriétés et les méthodes des données chargées sont accessibles. L’événement `init` précède toujours l’événement `complete`.

	`ioError:IOErrorEvent` — Distribué par l’objet `contentLoaderInfo` lorsque le moteur d’exécution ne parvient pas à analyser les données dans le tableau d’octets.

	`open:Event` — Distribué par l’objet `contentLoaderInfo` lorsque l’opération commence.

	`progress:ProgressEvent` — Distribué par l’objet `contentLoaderInfo` lors du transfert des données dans la mémoire.

	`securityError:SecurityErrorEvent` — Distribué par l’objet `contentLoaderInfo` si la propriété `LoaderContext.requestedContentParent` a été spécifiée et que le sandbox de sécurité du `LoaderContext.requestedContentParent` n’a pas accès au fichier SWF chargé.

	`unload:Event` — Distribué par l’objet `contentLoaderInfo` associé lorsqu’un objet chargé est supprimé.

Valeur émise

	`ArgumentError` — Si la propriété `length` de l’objet ByteArray n’est pas supérieure à 0.

	`IllegalOperationError` — Si la propriété `checkPolicyFile` ou `securityDomain` du paramètre `context` n’est pas réglée sur la valeur null.

	`IllegalOperationError` — Si la propriété `requestedContentParent` du paramètre `context` est un objet `ProLoader`.

	`IllegalOperationError` — Si le paramètre `LoaderContext.parameters` est défini sur une valeur non nulle et possède certaines valeurs qui ne sont pas des chaînes.

	`SecurityError` — Si la propriété `applicationDomain` proposée de la propriété `context` provient d’un domaine interdit.

	`SecurityError` — Vous ne pouvez pas vous connecter aux ports généralement réservés. Pour obtenir une liste complète des ports bloqués, voir la rubrique « Restriction des API de réseau » dans le Guide du développeur d’ActionScript 3.0.

Eléments de l’API associés

flash.utils.ByteArray
flash.system.LoaderContext.applicationDomain

loadFilePromise

()

méthode

public function loadFilePromise(promise:Object, context:LoaderContext = null):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

AIR 2.5, AIR 2.0, Flash Player 9

Charge une occurrence d’IFilePromise par le biais du paramètre promise. Le type du paramètre promise utilise la superclasse Object au lieu de IFilePromise afin d’éviter les erreurs dans les autres lecteurs.

La méthode loadFilePromise prend un objet IFilePromise et charge les données binaires. Si les données sont un flux progressif, par exemple une vidéo, attendez les événements "init" ou progress avant d’accéder aux propriétés de l’objet chargé. Dans le cas contraire, attendez l’événement complete pour vous assurer que les données sont entièrement chargées.

Si vous utilisez cette méthode, tenez compte du modèle de sécurité de Flash Player, expliqué dans la description de la classe ProLoader.

Paramètres

promise:Object — Un objet IFilePromise. La source de données de cet objet peut correspondre à n’importe quel type de format de fichier pris en charge par la classe ProLoader : SWF, GIF, JPEG ou PNG.

Pour plus d’informations concernant la sécurité, voir la rubrique du Pôle de développement Flash Player : Sécurité (disponible en anglais uniquement).

Evénements

	`asyncError:AsyncErrorEvent` — Distribué par l’objet `contentLoaderInfo` si la propriété `LoaderContext.requestedContentParent` a été spécifiée et qu’il est impossible d’ajouter le contenu chargé en tant qu’enfant au DisplayObjectContainer spécifié. C’est notamment le cas si le contenu chargé est un `flash.display.AVM1Movie` ou si l’appel de `addChild()` sur requestedContentParent renvoie une erreur.

	`complete:Event` — Distribué par l’objet `contentLoaderInfo` lorsque l’opération est terminée. L’événement `complete` est toujours distribué après l’événement `init`.

	`init:Event` — Distribué par l’objet `contentLoaderInfo` lorsque les propriétés et les méthodes des données chargées sont accessibles. L’événement `init` précède toujours l’événement `complete`.

	`ioError:IOErrorEvent` — Distribué par l’objet `contentLoaderInfo` lorsque le moteur d’exécution ne parvient pas à analyser les données dans la source de données ou si le flux de la source de données n’est plus lisible.

	`open:Event` — Distribué par l’objet `contentLoaderInfo` lorsque l’opération commence.

	`progress:ProgressEvent` — Distribué par l’objet `contentLoaderInfo` lors du transfert des données dans la mémoire.

	`securityError:SecurityErrorEvent` — Distribué par l’objet `contentLoaderInfo` si la propriété `LoaderContext.requestedContentParent` a été spécifiée et que le sandbox de sécurité du `LoaderContext.requestedContentParent` n’a pas accès au fichier SWF chargé.

	`unload:Event` — Distribué par l’objet `contentLoaderInfo` associé lorsqu’un objet chargé est supprimé. Avertissement : accéder à cette API en dehors des résultats d’une application AIR renvoie une erreur.

Valeur émise

	`IllegalOperationError` — Si la propriété `requestedContentParent` du paramètre `context` est un objet `ProLoader`.

	`IllegalOperationError` — Si le paramètre `LoaderContext.parameters` est défini sur une valeur non nulle et possède certaines valeurs qui ne sont pas des chaînes.

	`ArgumentError` — Si l’objet `IFilePromise` transmis en tant que paramètre est nul.

Eléments de l’API associés

MediaPromise
CameraRoll.browseForImage()
CameraUI

unload

()

méthode

public function unload():void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS5.5

Versions du moteur d’exécution:

AIR 1.0, Flash Player 9

Supprime un enfant de l’objet ProLoader chargé à l’aide de la méthode load(). La valeur property de l’objet ProLoaderInfo associé est réinitialisée sur null. L’enfant n’est pas nécessairement détruit, car d’autres objets risquent de s’y référer. Il n’est cependant plus un enfant de l’objet ProLoader.

Avant de décharger un fichier SWF enfant, il est recommandé de fermer explicitement tout flux continu dans les objets enfant du fichier SWF, tels que les objets LocalConnection, NetConnection, NetStream et Sound. Si vous n’effectuez pas cette opération, la lecture de l’audio risque de continuer dans le fichier SWF enfant, bien que ce dernier soit déchargé. Pour fermer les flux continus dans le fichier SWF enfant, ajoutez un écouteur d’événement à l’enfant qui écoute l’événement unload. Lorsque le parent appelle ProLoader.unload(), l’événement unload est distribué à l’enfant. L’exemple suivant illustre cette opération :

function closeAllStreams(evt:Event) { 
    myNetStream.close();
    mySound.close();
    myNetConnection.close();
    myLocalConnection.close();
}

myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);

Eléments de l’API associés

fl.display.ProLoader.load()
flash.media.Sound.close()
flash.net.LocalConnection.close()
flash.net.NetConnection.close()
flash.net.NetStream.close()
opérateur delete

Informations juridiques | Politique de confidentialité en ligne

ProLoader - AS3 Flash

Classes x

content

contentLoaderInfo

uncaughtErrorEvents

ProLoader

close

load

loadBytes

loadFilePromise

unload