UILoader

Package	fl.containers
Classe	public class UILoader
Héritage	UILoader UIComponent Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

La classe UILoader permet de définir le contenu à charger puis de contrôler l’opération de chargement au moment de l’exécution. Cette classe gère également le redimensionnement du contenu chargé. Si le contenu est chargé à partir d’un autre domaine (sandbox), des mesures de sécurité peuvent rendre ses propriétés inaccessibles. Pour plus d’informations, voir la classe ProLoader.

La définition d’une propriété de la classe UILoader à l’aide d’ActionScript a pour effet d’ignorer le paramètre du même nom défini dans l’inspecteur des propriétés ou l’inspecteur des composants.

Ce composant englobe flash.display.ProLoader. La classe ProLoader gère le chargement dans son ensemble ; le composant UILoader fournit uniquement un affichage visuel à l’objet ProLoader.

Remarque : si le contenu est chargé à partir d’un domaine ou d’un sandbox différent, les propriétés du contenu risquent de ne pas être accessibles pour des raisons de sécurité. Pour plus d’informations sur la façon dont la sécurité du domaine affecte le processus de chargement, voir la classe ProLoader.

Consulter les exemples

Eléments de l’API associés

ProLoader

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
		autoLoad : Boolean Récupère ou définit une valeur indiquant si l’occurrence du composant UILoader charge automatiquement le contenu spécifié.	UILoader
		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
		bytesLoaded : uint [lecture seule] Obtient le nombre d’octets de contenu qui a été chargé.	UILoader
		bytesTotal : uint [lecture seule] Obtient le nombre d’octets de contenu à charger.	UILoader
		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 image (fichier au format JPEG, PNG ou GIF) qui a été chargé à l’aide de la méthode load() ou en définissant la propriété source.	UILoader
		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
		enabled : Boolean Récupère ou définit une valeur indiquant si le composant peut accepter une interaction de l’utilisateur.	UIComponent
		filters : Array Tableau indexé contenant tous les objets filtre actuellement associés à l’objet d’affichage.	DisplayObject
		focusEnabled : Boolean Récupère ou définit une valeur booléenne indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée.	UIComponent
		focusManager : IFocusManager Récupère ou définit le FocusManager qui contrôle le focus pour ce composant et ses homologues.	UIComponent
		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 [override] Récupère ou définit la hauteur du composant, en pixels.	UIComponent
		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
		maintainAspectRatio : Boolean Récupère ou définit une valeur qui indique si le format utilisé dans l’image d’origine doit être conservé ou si l’image doit être redimensionnée en fonction de la largeur et de la hauteur actuelles du composant UILoader.	UILoader
		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
		mouseFocusEnabled : Boolean Récupère ou définit une valeur indiquant si le composant peut recevoir le focus après un clic de l’utilisateur sur son entrée.	UIComponent
		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
		percentLoaded : Number [lecture seule] Récupère un nombre compris entre 0 et 100 indiquant le pourcentage de contenu qui est chargé.	UILoader
		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
		scaleContent : Boolean Récupère ou définit une valeur indiquant si l’image est automatiquement ajustée à la taille de l’occurrence du composant UILoader.	UILoader
		scaleX : Number [override] Multiplie la largeur actuelle du composant par un facteur de redimensionnement.	UIComponent
		scaleY : Number [override] Multiplie la hauteur actuelle du composant par un facteur de redimensionnement.	UIComponent
		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
		source : Object Récupère ou définit une URL absolue ou relative qui identifie l’emplacement du fichier SWF ou de l’image à charger, le nom de la classe d’un clip dans la bibliothèque, une référence à un objet d’affichage ou le nom d’une occurrence de clip au même niveau que le composant.	UILoader
		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
		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 [override] Récupère ou définit une valeur indiquant si l’occurrence du composant actif est visible.	UIComponent
		width : Number [override] Récupère ou définit la largeur du composant, en pixels.	UIComponent
		x : Number [override] Récupère ou définit la coordonnée x représentant la position du composant le long de l’axe x au sein de son conteneur parent.	UIComponent
		y : Number [override] Récupère ou définit la coordonnée y représentant la position du composant le long de l’axe y au sein de son conteneur parent.	UIComponent
		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
		UILoader() Crée une nouvelle occurrence du composant UILoader.	UILoader
		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
		clearStyle(style:String):void Définit une propriété de style depuis cette occurrence de composant.	UIComponent
		close():void Annule une opération associée à la méthode load() actuellement en cours d’exécution pour l’occurrence de ProLoader.	UILoader
		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
		drawFocus(focused:Boolean):void Affiche ou masque l’indicateur de focus dans ce composant.	UIComponent
		drawNow():void Déclenche une opération de dessin immédiate, sans tout annuler comme le fait invalidateNow.	UIComponent
		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
		getFocus():InteractiveObject Récupère l’objet qui détient actuellement le focus.	UIComponent
		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
		getStyle(style:String):Object Extrait une propriété de style définie dans la chaîne de recherche de style du composant.	UIComponent
		getStyleDefinition():Object [statique] Récupère la texture de style par défaut du composant actif.	UILoader
		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
		invalidate(property:String, callLater:Boolean = true):void Marque une propriété comme non valide, puis redessine le composant dans la prochaine image, sauf spécification contraire.	UIComponent
		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 = null, context:LoaderContext = null):void Charge le contenu spécifié ou, à défaut de contenu spécifié, charge le contenu situé à l’emplacement identifié par la propriété source.	UILoader
		loadBytes(bytes:ByteArray, context:LoaderContext = null):void Charge les données binaires stockées dans un objet ByteArray.	UILoader
		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
		mergeStyles(... list):Object [statique] Fusionne les styles de plusieurs classes en un seul objet.	UIComponent
		move(x:Number, y:Number):void Déplace le composant à la position spécifiée dans son parent.	UIComponent
		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
		setFocus():void Définit le focus sur ce composant.	UIComponent
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.	Object
		setSize(w:Number, h:Number):void [override] Redimensionne le composant à la taille demandée.	UILoader
		setStyle(style:String, value:Object):void Définit une propriété de style pour cette occurrence de composant.	UIComponent
		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 cet objet UILoader qui a été chargé à l’aide de la méthode load() ou de la propriété source.	UILoader
		validateNow():void Valide et met à jour les propriétés et la mise en forme de cet objet, puis le redessine si nécessaire.	UIComponent
		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
		getStyleValue(name:String):Object Renvoie le style spécifié pour un composant, en tenant compte de tous les styles définis au niveau global, au niveau du composant et au niveau de l’occurrence.	UIComponent

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
complete	Distribué lorsque le chargement du contenu est terminé.	UILoader
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
hide	Distribué après que la visibilité du composant soit passée de visible à invisible.	UIComponent
imeStartComposition	Cet événement est distribué à une application cliente prenant en charge la saisie en ligne avec un éditeur IME.	InteractiveObject
init	Distribué lorsqu’il est possible d’accéder aux propriétés et aux méthodes d’un fichier SWF chargé.	UILoader
ioError	Distribué après qu’une erreur d’entrée/sortie se soit produite.	UILoader
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
move	Distribué à la suite du déplacement du composant.	UIComponent
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
open	Distribué après le démarrage d’une opération réseau.	UILoader
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
progress	Distribué lors du chargement de contenu.	UILoader
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
resize	Distribué à la suite du redimensionnement du composant.	UILoader
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
securityError	Distribué après qu'une erreur de sécurité se soit produite pendant le chargement du contenu.	UILoader
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
show	Distribué après que la visibilité du composant soit passée de invisible à visible.	UIComponent
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

Styles

Les styles sont soit communs soit associés à un thème spécifique. Si le style est commun, il peut être utilisé avec n’importe quel thème. Si un style est associé à un thème spécifique, il ne peut être utilisé que si votre application utilise ce thème.

Styles communs

Cliquez pour plus d’informations sur les styles

Masquer les styles hérités

Afficher les styles hérités

	Description	Défini par
disabledTextFormat	Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Objet TextFormat à utiliser pour le rendu de l’étiquette du composant lorsque le bouton est désactivé.	UIComponent
focusRectPadding	Type: Number Format: Length Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Remplissage qui sépare les limites extérieures du composant et les bords extérieurs de l’indicateur du focus, en pixels.	UIComponent
focusRectSkin	Type: Class Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Enveloppe à utiliser pour afficher les indicateurs de focus.	UIComponent
textFormat	Type: flash.text.TextFormat Version du langage: ActionScript 3.0 Version du produit: Flash CS3 Versions du moteur d’exécution: Flash9.0.28.0, AIR 1.0 Objet TextFormat à utiliser pour le rendu de l’étiquette du composant.	UIComponent

Constantes publiques

Masquer les constantes publiques héritées

Afficher les constantes publiques héritées

	Constante		Défini par
		version : String = "3.0.3.1" Numéro de version des composants.	UIComponent

Détails de la propriété

autoLoad

propriété

autoLoad:Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère ou définit une valeur indiquant si l’occurrence du composant UILoader charge automatiquement le contenu spécifié. La valeur true indique que le composant UILoader charge automatiquement le contenu ; la valeur false indique que le contenu n’est pas chargé tant que la méthode load() n’est pas appelée.

La valeur par défaut est true.

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

Eléments de l’API associés

load()
source

Exemple ( Comment utiliser cet exemple )

L’exemple suivant montre comment la définition de la propriété autoLoad sur false empêche le chargement du contenu jusqu’à l’appel de la méthode load() :


import fl.containers.UILoader;
import fl.controls.Button;

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 40);
addChild(myUILoader);

var myButton:Button = new Button();
myButton.label = "Load image";
myButton.move(10, 10);
myButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myButton);

function clickHandler(event:MouseEvent):void {
    myUILoader.load();
}

bytesLoaded

propriété

bytesLoaded:uint [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Obtient le nombre d’octets de contenu qui a été chargé. Lorsque cette propriété atteint la valeur de bytesTotal, cela signifie que tous les octets sont chargés.

La valeur par défaut est 0.

Implémentation
public function get bytesLoaded():uint

Eléments de l’API associés

bytesTotal
percentLoaded

Exemple ( Comment utiliser cet exemple )

L'exemple suivant crée une occurrence de composant UILoader qui affiche une image chargée, et une occurrence des composants ProgressBar et Label qui affichent le statut de téléchargement actuel de l'image :


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

bytesTotal

propriété

bytesTotal:uint [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Obtient le nombre d’octets de contenu à charger.

La valeur par défaut est 0.

Implémentation
public function get bytesTotal():uint

Eléments de l’API associés

bytesLoaded
percentLoaded

Exemple ( Comment utiliser cet exemple )


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

content

propriété

content:DisplayObject [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Contient l’objet d’affichage racine du fichier SWF ou du fichier image (fichier au format JPEG, PNG ou GIF) qui a été chargé à l’aide de la méthode load() ou en définissant la propriété source. La valeur est undefined jusqu’à ce que le chargement commence. Définissez les propriétés du contenu dans une fonction de gestionnaire d’événement pour l’événement complete.

La valeur par défaut est null.

Implémentation
public function get content():DisplayObject

Eléments de l’API associés

complete
load()
source

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée un curseur qui modifie la transparence du contenu d’un objet UILoader :


import fl.controls.Slider;
import fl.containers.UILoader;
import fl.events.SliderEvent;

var s:Slider = new Slider();
s.minimum = 10;
s.maximum = 100;
s.liveDragging = true;
s.value = s.maximum;
s.move(10,10);
s.addEventListener(SliderEvent.THUMB_DRAG, updateUILoaderContentAlpha);
addChild(s);

var loader:UILoader = new UILoader();
loader.move(10,40);
loader.setSize(400, 300);
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

function updateUILoaderContentAlpha(e:SliderEvent):void {
    loader.content.alpha = s.value/100;
}

maintainAspectRatio

propriété

maintainAspectRatio:Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère ou définit une valeur qui indique si le format utilisé dans l’image d’origine doit être conservé ou si l’image doit être redimensionnée en fonction de la largeur et de la hauteur actuelles du composant UILoader. La valeur true indique que le format d’origine est conservé ; la valeur false indique que le contenu chargé est redimensionné en fonction des dimensions actuelles du composant UILoader.

Pour utiliser cette propriété, vous devez définir la propriété scaleContent sur false. A défaut, cette propriété est ignorée.

La valeur par défaut est true.

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

Eléments de l’API associés

scaleContent

Exemple ( Comment utiliser cet exemple )

L’exemple suivant utilise une case à cocher pour inverser la valeur de la propriété maintainAspectRatio :


import fl.containers.UILoader;
import fl.controls.CheckBox;

var myUILoader:UILoader = new UILoader();
myUILoader.setSize(200, 200);
myUILoader.scaleContent = true;
myUILoader.maintainAspectRatio = true;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.move(10, 10);
addChild(myUILoader);

var myCheckBox:CheckBox = new CheckBox();
myCheckBox.label = "maintainAspectRatio";
myCheckBox.selected = myUILoader.maintainAspectRatio;
myCheckBox.width = 150;
myCheckBox.move(220, 10);
myCheckBox.addEventListener(Event.CHANGE, changeHandler);
addChild(myCheckBox);

function changeHandler(event:Event):void {
    myUILoader.maintainAspectRatio = event.target.selected;
}

percentLoaded

propriété

percentLoaded:Number [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère un nombre compris entre 0 et 100 indiquant le pourcentage de contenu qui est chargé. Si vous chargez des actifs de votre bibliothèque et non du contenu chargé à l’extérieur, la propriété percentLoaded a la valeur 0.

La valeur par défaut est 0.

Implémentation
public function get percentLoaded():Number

Eléments de l’API associés

bytesLoaded
bytesTotal

Exemple ( Comment utiliser cet exemple )


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

scaleContent

propriété

scaleContent:Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère ou définit une valeur indiquant si l’image est automatiquement ajustée à la taille de l’occurrence du composant UILoader. La valeur true indique que l’image est automatiquement ajustée à la taille de l’occurrence du composant UILoader ; la valeur false indique que le contenu chargé est automatiquement ajusté en fonction de sa taille par défaut.

La valeur par défaut est true.

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

Eléments de l’API associés

maintainAspectRatio

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée un objet UILoader qui charge et adapte les dimensions d’une image :


import fl.containers.UILoader;

var loader:UILoader = new UILoader();
loader.scaleContent = false;
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

source

propriété

source:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère ou définit une URL absolue ou relative qui identifie l’emplacement du fichier SWF ou de l’image à charger, le nom de la classe d’un clip dans la bibliothèque, une référence à un objet d’affichage ou le nom d’une occurrence de clip au même niveau que le composant.

Les formats de fichier image valides sont GIF, PNG et JPEG. Pour charger un actif à l’aide d’un objet URLRequest, utilisez la méthode load().

La valeur par défaut est null.

Implémentation
public function get source():Object
public function set source(value:Object):void

Eléments de l’API associés

autoLoad
load()

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée un objet UILoader qui charge et adapte les dimensions d’une image :

import fl.containers.UILoader;

var loader:UILoader = new UILoader();
loader.scaleContent = false;
loader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
addChild(loader);

Détails du constructeur

()

Constructeur

public function UILoader()

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Crée une nouvelle occurrence du composant UILoader.

Détails de la méthode

close

()

méthode

public function close():void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Annule une opération associée à la méthode load() qui est en cours d’exécution pour l’occurrence de ProLoader. La méthode load() peut également être appelée à partir du paramètre source.

Valeur émise

Error — L’objet URLStream n’a pas de flux ouvert.

Eléments de l’API associés

load()
source

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence du composant UILoader et une occurrence du composant Button qui permet d’annuler le téléchargement de l’image de l’occurrence d’UILoader :


import fl.containers.UILoader;
import fl.controls.Button;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 30);
addChild(myUILoader);

var cancelButton:Button = new Button();
cancelButton.label = "Cancel download";
cancelButton.move(10, 10);
cancelButton.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(cancelButton);

function clickHandler(event:MouseEvent):void {
    var uil:UILoader = myUILoader;
    try {
        uil.close();
        trace("Download cancelled:", uil.source);
    } catch (error:Error) {
        trace("Unable to cancel download.", error.message);
    }
}

getStyleDefinition

()

méthode

public static function getStyleDefinition():Object

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Récupère la texture de style par défaut du composant actif. La texture de style contient le type adapté au composant, qui dépend du style utilisé par ce dernier. Par exemple, le style disabledTextFormat contient la valeur null ou un objet TextFormat. Vous pouvez utiliser ces styles et appeler setStyle() pour le composant actif. Le code suivant ignore le style par défaut disabledTextFormat dans le composant spécifié :

componentInstance.setStyle("disabledTextFormat", new TextFormat());

Valeur renvoyée

Object — Objet de styles par défaut.

Eléments de l’API associés

UIComponent.getStyle()
UIComponent.setStyle()
StyleManager

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée un navigateur de styles pour différentes classes de composant :

import fl.controls.*;
import fl.containers.*;
import fl.controls.listClasses.*;
import fl.controls.dataGridClasses.*;
import fl.controls.progressBarClasses.*;
import fl.core.UIComponent;
import fl.data.DataProvider;

var dp:DataProvider = new DataProvider();
dp.addItem( { label: "BaseScrollPane",    data:BaseScrollPane } );
dp.addItem( { label: "Button",             data:Button } );
dp.addItem( { label: "CellRenderer",    data:CellRenderer } );
dp.addItem( { label: "CheckBox",         data:CheckBox } );
dp.addItem( { label: "ColorPicker",     data:ColorPicker } );
dp.addItem( { label: "ComboBox",         data:ComboBox } );
dp.addItem( { label: "DataGrid",         data:DataGrid } );
dp.addItem( { label: "HeaderRenderer",    data:HeaderRenderer } );
dp.addItem( { label: "ImageCell",        data:ImageCell } );
dp.addItem( { label: "IndeterminateBar",data:IndeterminateBar } );
dp.addItem( { label: "Label",             data:Label } );
dp.addItem( { label: "List",             data:List } );
dp.addItem( { label: "NumericStepper",     data:NumericStepper } );
dp.addItem( { label: "ProgressBar",     data:ProgressBar } );
dp.addItem( { label: "RadioButton",     data:RadioButton } );
dp.addItem( { label: "ScrollPane",         data:ScrollPane } );
dp.addItem( { label: "Slider",             data:Slider } );
dp.addItem( { label: "TextArea",         data:TextArea } );
dp.addItem( { label: "TextInput",         data:TextInput } );
dp.addItem( { label: "TileList",         data:TileList } );
dp.addItem( { label: "UILoader",         data:UILoader } );
dp.addItem( { label: "UIComponent",     data:UIComponent } );

var cb:ComboBox = new ComboBox();
cb.move(10,10);
cb.setSize(300,25);
cb.prompt = "Select a component to view its styles";
cb.rowCount = 12;
cb.dataProvider = dp;
cb.addEventListener(Event.CHANGE, showStyleDefinition);
addChild(cb);

var dg:DataGrid = new DataGrid();
dg.setSize(425,300);
dg.move(10,50);
dg.columns = [ new DataGridColumn("StyleName"), new DataGridColumn("DefaultValue") ];
addChild(dg);

function showStyleDefinition(e:Event):void {
    var componentClass:Class = e.target.selectedItem.data as Class;
    var styles:Object = componentClass["getStyleDefinition"].call(this);
    trace(styles.toString());
    var styleData:DataProvider = new DataProvider();
    for(var i:* in styles) {
        trace(i + " : " + styles[i]);
        styleData.addItem( { StyleName:i, DefaultValue:styles[i] } );
    }
    styleData.sortOn("StyleName");
    dg.dataProvider = styleData;
}

load

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Charge le contenu spécifié ou, à défaut de contenu spécifié, charge le contenu situé à l’emplacement identifié par la propriété source. Par défaut, l’objet LoaderContext utilise le domaine actuel comme domaine d’application. Pour spécifier un autre domaine d’application, rechercher un fichier de régulation ou modifier le domaine de sécurité, initialisez un nouvel objet LoaderContext et transmettez-le à cette méthode.

Par défaut, la propriété context utilise le domaine actuel. Pour spécifier un autre objet ApplicationDomain, rechercher un fichier de régulation ou modifier l’objet SecurityDomain, transmettez un nouvel objet LoaderContext.

Paramètres

	`request:URLRequest` (default = `null`) — Objet URLRequest identifiant l’emplacement d’où est chargé le contenu. Si cette valeur n’est pas spécifiée, la valeur actuelle de la propriété `source` est utilisée comme emplacement de contenu.

	`context:LoaderContext` (default = `null`) — Objet LoaderContext définissant le contexte de l’opération de chargement.

Eléments de l’API associés

autoLoad
close()
source
unload()
flash.system.ApplicationDomain
flash.system.LoaderContext

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une nouvelle occurrence du composant UILoader et charge une image à l’aide de la méthode load() avec la propriété source :


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.autoLoad = false;
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.load();
myUILoader.move(10, 10);
addChild(myUILoader);

L’exemple suivant crée une nouvelle occurrence du composant UILoader et charge une image à l’aide de la méthode load() avec une occurrence d’URLRequest :


import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";
var req:URLRequest = new URLRequest(url);

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.move(10, 10);
myUILoader.load(req);
addChild(myUILoader);

loadBytes

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

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

Paramètres

	`bytes:ByteArray` — Objet ByteArray contenant un fichier dont le format est pris en charge par la classe ProLoader : SWF, GIF, JPEG ou PNG.

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

Valeur émise

	`ArgumentError` — La propriété `length` de l’objet ByteArray a pour valeur 0.

	`IllegalOperationError` — La propriété `checkPolicyFile` ou `securityDomain` du paramètre `context` n’a pas la valeur null.

	`SecurityError` — La propriété `applicationDomain` de la propriété `context` qui a été fournie provient d’un domaine non autorisé.

Eléments de l’API associés

source
ProLoader.loadBytes()
LoaderContext

Exemple ( Comment utiliser cet exemple )

L’exemple suivant charge les octets bruts d’un fichier GIF dans un objet UILoader :

import fl.containers.UILoader;

var imageBytes:Array = [ 71, 73, 70, 56, 57, 97, 50, 0, 30, 0, 230, 0, 0, 0, 0, 0, 173, 169, 206, 82, 73, 153, 74, 74, 74, 115, 109, 155, 248, 247, 251, 102, 102, 102, 26, 24, 35, 181, 181, 181, 70, 61, 145, 222, 222, 222, 153, 153, 153, 204, 204, 204, 58, 58, 58, 132, 132, 132, 231, 231, 231, 8, 7, 14, 90, 90, 90, 89, 81, 163, 153, 153, 153, 191, 188, 217, 165, 165, 165, 190, 190, 190, 237, 237, 233, 51, 51, 51, 214, 214, 214, 90, 82, 156, 156, 152, 190, 123, 123, 123, 140, 140, 140, 140, 135, 187, 103, 96, 165, 78, 70, 150, 173, 173, 173, 127, 121, 179, 82, 82, 82, 206, 204, 226, 195, 195, 193, 102, 102, 102, 247, 247, 247, 41, 41, 41, 66, 66, 66, 183, 179, 212, 146, 141, 190, 21, 21, 20, 227, 226, 238, 119, 111, 181, 198, 195, 221, 99, 91, 162, 255, 255, 255, 218, 216, 233, 114, 114, 114, 16, 15, 27, 114, 107, 171, 210, 208, 228, 8, 8, 8, 179, 175, 209, 240, 239, 246, 153, 153, 153, 234, 233, 243, 95, 88, 160, 90, 74, 156, 33, 33, 33, 16, 16, 16, 163, 159, 200, 142, 137, 188, 197, 189, 222, 134, 129, 183, 151, 147, 193, 202, 199, 223, 222, 221, 235, 122, 115, 176, 215, 213, 231, 74, 66, 147, 82, 75, 146, 197, 197, 197, 106, 99, 166, 231, 230, 240, 175, 171, 207, 239, 239, 239, 209, 207, 227, 25, 25, 22, 119, 112, 182, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 33, 249, 4, 0, 7, 0, 255, 0, 44, 0, 0, 0, 0, 50, 0, 30, 0, 0, 7, 255, 128, 49, 130, 131, 132, 132, 8, 24, 0, 16, 6, 15, 133, 141, 5, 54, 69, 77, 141, 147, 148, 147, 51, 63, 0, 153, 0, 40, 8, 148, 5, 1, 53, 48, 48, 31, 30, 50, 149, 167, 133, 5, 41, 154, 172, 0, 33, 141, 59, 76, 9, 2, 26, 181, 32, 32, 42, 168, 168, 170, 173, 172, 63, 23, 132, 59, 31, 32, 181, 197, 181, 73, 185, 186, 147, 5, 3, 189, 173, 29, 131, 194, 196, 198, 198, 184, 202, 141, 205, 206, 172, 35, 130, 77, 195, 212, 224, 73, 56, 215, 131, 217, 218, 154, 41, 49, 222, 211, 224, 212, 226, 228, 230, 231, 153, 6, 5, 223, 237, 237, 239, 186, 241, 242, 0, 11, 46, 236, 247, 194, 5, 64, 181, 79, 222, 129, 15, 180, 2, 6, 76, 226, 164, 82, 193, 115, 52, 148, 72, 80, 72, 145, 225, 164, 135, 218, 34, 242, 160, 200, 145, 225, 133, 12, 229, 248, 177, 210, 200, 177, 36, 136, 13, 140, 98, 112, 16, 169, 9, 130, 146, 141, 37, 75, 38, 121, 17, 195, 2, 38, 150, 81, 8, 76, 228, 40, 160, 39, 79, 38, 77, 26, 176, 4, 192, 130, 129, 148, 132, 10, 147, 0, 65, 162, 1, 169, 194, 32, 67, 127, 100, 40, 224, 244, 94, 18, 34, 130, 108, 248, 228, 200, 242, 7, 131, 24, 70, 170, 134, 91, 65, 8, 202, 86, 133, 17, 248, 121, 21, 148, 131, 135, 216, 98, 73, 255, 130, 52, 42, 114, 182, 157, 8, 5, 62, 206, 173, 29, 228, 33, 137, 85, 15, 148, 232, 190, 213, 0, 195, 84, 5, 109, 123, 7, 181, 104, 26, 110, 200, 169, 23, 32, 196, 38, 24, 40, 168, 195, 141, 86, 40, 190, 54, 34, 161, 33, 73, 207, 158, 73, 0, 163, 122, 33, 192, 115, 79, 16, 87, 11, 101, 152, 209, 0, 195, 128, 5, 39, 42, 237, 32, 194, 132, 7, 143, 35, 20, 174, 181, 88, 241, 193, 182, 8, 154, 228, 42, 229, 200, 17, 188, 184, 241, 224, 29, 150, 148, 0, 25, 35, 67, 133, 24, 39, 20, 44, 89, 18, 3, 1, 243, 37, 8, 136, 215, 68, 112, 34, 250, 146, 39, 5, 16, 88, 16, 36, 125, 73, 120, 230, 25, 16, 164, 44, 81, 194, 0, 2, 235, 5, 44, 116, 232, 244, 0, 67, 135, 8, 41, 58, 52, 200, 80, 194, 129, 131, 1, 49, 204, 48, 195, 2, 6, 224, 197, 65, 6, 35, 44, 192, 193, 12, 57, 160, 112, 95, 126, 13, 40, 16, 130, 1, 21, 140, 144, 129, 3, 51, 84, 128, 194, 18, 28, 148, 32, 31, 7, 6, 196, 160, 64, 4, 49, 44, 65, 162, 3, 11, 88, 128, 98, 10, 10, 164, 35, 72, 6, 0, 46, 48, 131, 32, 3, 88, 64, 98, 123, 42, 85, 136, 226, 12, 29, 112, 163, 146, 5, 28, 88, 16, 66, 7, 11, 0, 56, 98, 77, 33, 162, 56, 194, 88, 18, 10, 52, 240, 64, 4, 22, 40, 208, 1, 3, 36, 50, 48, 130, 116, 17, 28, 9, 100, 12, 14, 132, 224, 64, 7, 82, 142, 168, 94, 10, 37, 112, 16, 66, 10, 25, 48, 144, 194, 5, 90, 38, 89, 193, 2, 40, 140, 128, 65, 5, 12, 248, 224, 3, 7, 79, 10, 226, 128, 157, 37, 156, 192, 141, 5, 51, 114, 80, 193, 19, 24, 196, 121, 66, 157, 173, 49, 208, 161, 3, 40, 68, 208, 0, 7, 129, 0, 0, 59 ];

var totalBytes:uint = imageBytes.length;
var newBytes:ByteArray = new ByteArray()
var i:uint;
for(i=0; i<totalBytes; i++) {
    newBytes.writeByte(imageBytes[i]);
}

var loader:UILoader = new UILoader();
loader.loadBytes(newBytes);
addChild(loader);

setSize

()

méthode

override public function setSize(w:Number, h:Number):void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Redimensionne le composant à la taille demandée. Si la propriété scaleContent a la valeur true, le composant UILoader n’est pas redimensionné.

Paramètres

	`w:Number` — Largeur du composant, en pixels.

	`h:Number` — Hauteur du composant, en pixels.

Eléments de l’API associés

scaleContent

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence du composant UILoader et la redimensionne sur la scène à l’aide de la méthode setSize() :


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
addChild(myUILoader);

function completeHandler(event:Event):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var image:DisplayObject = uiLdr.content as DisplayObject;
    trace("UILoader:", uiLdr.width, uiLdr.height); // 100 100
    trace("UILoader.content:", image.width, image.height); // 400 267
    uiLdr.setSize(image.width, image.height);
    uiLdr.move((stage.stageWidth - image.width) / 2, (stage.stageHeight - image.height) / 2);
}

unload

()

méthode

public function unload():void

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Supprime un enfant de cet objet UILoader qui a été chargé à l’aide de la méthode load() ou de la propriété source.

Eléments de l’API associés

load()
source

Exemple ( Comment utiliser cet exemple )

L’exemple suivant charge une image dans un composant UILoader et la décharge lorsque l’événement click de ce composant est distribué :


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.source = "http://www.helpexamples.com/flash/images/image1.jpg";
myUILoader.move(10, 10);
myUILoader.addEventListener(MouseEvent.CLICK, clickHandler);
addChild(myUILoader);

function clickHandler(event:MouseEvent):void {
    var uil:UILoader = event.currentTarget as UILoader;
    uil.unload();
    removeChild(uil);
}

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:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Distribué lorsque le chargement du contenu est terminé. Cet événement est distribué, que l’opération de chargement ait été déclenchée par un processus de chargement automatique ou par un appel explicite à la méthode load().

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é.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence d’UILoader et, après le chargement de l’image spécifiée, centre celle-ci sur la scène :


import fl.containers.UILoader;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image2.jpg";
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
addChild(myUILoader);

function completeHandler(event:Event):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var newX:uint = (stage.stageWidth - uiLdr.content.width) / 2;
    var newY:uint = (stage.stageHeight - uiLdr.content.height) / 2;
    uiLdr.move(newX, newY);
}

Eléments de l’API associés

progress

init

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.INIT

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Distribué lorsqu’il est possible d’accéder aux propriétés et aux méthodes d’un fichier SWF chargé. Pour que cet événement soit distribué, les conditions suivantes doivent être remplies :

Toutes les propriétés et méthodes associées à l’objet chargé, ainsi que celles associées au composant, doivent être accessibles.
L'exécution des constructeurs de tous les objets enfants doit être terminée.

La constante Event.INIT définit la valeur de la propriété type d’un objet événement init.

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 LoaderInfo associé au fichier SWF en cours de chargement.

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:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Distribué après qu’une erreur d’entrée/sortie se soit produite.

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.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence de composant UILoader et tente de charger un fichier inexistant, ce qui provoque la diffusion d’un événement ioError :


import fl.containers.UILoader;

var url:String = "http://www.helpexamples.com/flash/images/image404.jpg"

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.move(10, 10);
myUILoader.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
addChild(myUILoader);

function ioErrorHandler(event:IOErrorEvent):void {
    trace("<<", event.text, ">>");
    myUILoader.removeEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
    removeChild(myUILoader);
}

open

Evénement

Type d’objet d’événement: flash.events.Event
propriété Event.type = flash.events.Event.OPEN

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Distribué après le démarrage d’une opération réseau.

La constante Event.OPEN définit la valeur de la propriété type d’un objet événement open.

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 qui a ouvert une connexion.

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:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Distribué lors du chargement de contenu. Cet événement est distribué, que l’opération de chargement ait été déclenchée par un processus de chargement automatique ou par un appel explicite à la méthode load().

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.

Exemple ( Comment utiliser cet exemple )


import fl.containers.UILoader;
import fl.controls.Label;
import fl.controls.ProgressBar;
import fl.controls.ProgressBarMode;

var url:String = "http://www.helpexamples.com/flash/images/image3.jpg";

var myLabel:Label = new Label();
myLabel.autoSize = TextFieldAutoSize.LEFT;
myLabel.text = "";
myLabel.move(10, 10);
addChild(myLabel);

var myProgressBar:ProgressBar = new ProgressBar();
myProgressBar.mode = ProgressBarMode.MANUAL;
myProgressBar.move(10, 30);
addChild(myProgressBar);

var myUILoader:UILoader = new UILoader();
myUILoader.load(new URLRequest(url));
myUILoader.addEventListener(ProgressEvent.PROGRESS, progressHandler);
myUILoader.addEventListener(Event.COMPLETE, completeHandler);
myUILoader.move(10, 35);
addChild(myUILoader);

function progressHandler(event:ProgressEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    var kbLoaded:String = Number(uiLdr.bytesLoaded / 1024).toFixed(1);
    var kbTotal:String = Number(uiLdr.bytesTotal / 1024).toFixed(1);
    myLabel.text = kbLoaded + " of " + kbTotal + " KB" + " (" + Math.round(uiLdr.percentLoaded) + "%)";
    myProgressBar.setProgress(event.bytesLoaded, event.bytesTotal);
}

function completeHandler(event:Event):void {
    myLabel.visible = false;
    myProgressBar.visible = false;
    myUILoader.removeEventListener(ProgressEvent.PROGRESS, progressHandler);
    myUILoader.removeEventListener(Event.COMPLETE, completeHandler);
}

Eléments de l’API associés

complete

resize

Evénement

Type d’objet d’événement: fl.events.ComponentEvent
propriété ComponentEvent.type = fl.events.ComponentEvent.RESIZE

Version du langage:

ActionScript 3.0

Version du produit:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Distribué à la suite du redimensionnement du composant.

Définit la valeur de la propriété type d’un objet d’événement resize.

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`	Objet qui traite activement l’objet de l’événement avec un écouteur d’événement.
`target`	Objet qui a distribué l’événement. La cible n’est pas toujours l’objet écoutant l’événement. Pour accéder à l’objet qui écoute l’événement, utilisez la propriété `currentTarget`.

Exemple ( Comment utiliser cet exemple )

L’exemple suivant crée une occurrence de composant UILoader, écoute l’événement resize et centre l’image sur la scène à la fin de son chargement :


import fl.containers.UILoader;
import fl.events.ComponentEvent;

var myUILoader:UILoader = new UILoader();
myUILoader.scaleContent = false;
myUILoader.source = "http://www.helpexamples.com/flash/images/image3.jpg";
myUILoader.addEventListener(ComponentEvent.RESIZE, resizeHandler);
addChild(myUILoader);

function resizeHandler(event:ComponentEvent):void {
    var uiLdr:UILoader = event.currentTarget as UILoader;
    trace(uiLdr.width, uiLdr.height); // 400 267
    uiLdr.move((stage.stageWidth - uiLdr.width) / 2, (stage.stageHeight - uiLdr.height) / 2);
}

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:

Flash CS3

Versions du moteur d’exécution:

Flash Player 9.0.28.0, AIR 1.0

Distribué après qu'une erreur de sécurité se soit produite pendant le chargement du contenu.

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.

Exemples Comment utiliser cet exemple

UILoaderExample.as

Cet exemple illustre une interaction simple avec la classe UILoader.

Placez une occurrence de UILoader sur la scène et nommez-la « uiLoader ».
Placez une occurrence de Label au-dessus de l’occurrence de UILoader et nommez-la « uiLoaderLabel ».
Enregistrez ce code sous le nom UILoaderExample.as dans le même répertoire que votre fichier FLA.
Dans le fichier FLA, définissez DocumentClass sur UILoaderExample.

package
{
    import flash.display.Sprite;
    import flash.net.URLRequest;
    import flash.events.Event;
    import flash.events.ProgressEvent;

    public class UILoaderExample extends Sprite
    {
        private var sampleImagePath:String = "test.jpg";
        
        public function UILoaderExample() {
            var request:URLRequest = new URLRequest(sampleImagePath);
            uiLoader.scaleContent = false;
            uiLoader.addEventListener(Event.COMPLETE,loadComplete);
            uiLoader.addEventListener(ProgressEvent.PROGRESS,loadProgress);            
            uiLoader.load(request);
        }
        private function loadProgress(e:ProgressEvent):void {
            uiLoaderLabel.text = String(e.target.percentLoaded);
        }
        private function loadComplete(e:Event):void {
            uiLoaderLabel.text = "Load Complete";    
        }
    }
}

Informations juridiques | Politique de confidentialité en ligne

UILoader - AS3 Flash

Classes x

autoLoad

bytesLoaded

bytesTotal

content

maintainAspectRatio

percentLoaded

scaleContent

source

UILoader

close

getStyleDefinition

load

loadBytes

setSize

unload

complete

init

ioError

open

progress

resize

securityError