Packageflash.display
Classepublic class LoaderInfo
HéritageLoaderInfo Inheritance EventDispatcher Inheritance Object

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

La classe LoaderInfo fournit des informations relatives à un fichier SWF ou à un fichier d’image (JPEG, GIF ou PNG) chargé. Les objets LoaderInfo sont disponibles pour n’importe quel objet d'affichage. Les informations indiquées comprennent la progression du chargement, les URL de l’objet Loader et du contenu chargé, le nombre total d’octets du média, ainsi que la hauteur et la largeur nominales de ce dernier.

Vous pouvez accéder aux objets LoaderInfo de deux façons :

La propriété contentLoaderInfo d’un objet Loader fournit des informations sur le contenu chargé par cet objet, tandis que la propriété loaderInfo d’un objet DisplayObject propose des informations sur le fichier SWF racine correspondant à l’objet d'affichage.

La propriété loaderInfo d’un objet chargé avec un objet Loader (fichier SWF ou bitmap) se réfère au même objet LoaderInfo que la propriété contentLoaderInfo de l’objet Loader. En d’autres termes, un objet LoaderInfo est partagé entre un fichier d’objet chargé et l’objet Loader qui l’a chargé. Parce que l’occurrence de la classe principale du fichier SWF ne dispose pas d’un objet Loader, la propriété loaderInfo constitue pour elle l’unique moyen d’accéder à LoaderInfo.

Le diagramme ci-dessous indique les différentes utilisations de l’objet LoaderInfo pour l’occurrence de la classe principale du fichier SWF, pour la propriété contentLoaderInfo d’un objet Loader et pour la propriété loaderInfo d’un objet chargé :

Certaines propriétés de la propriété contentLoaderInfo d’un objet Loader ne sont pas disponibles tant que l’opération de chargement n’est pas terminée. Vous avez cependant accès à certaines propriétés, telles que bytesLoaded, bytesTotal, url, loaderURL et applicationDomain. Lorsque l’objet loaderInfo distribue l’événement init, vous pouvez accéder à toutes ses propriétésloaderInfo, ainsi qu’à l’image ou au fichier SWF chargés.

Remarque : toutes les propriétés des objets LoaderInfo sont accessibles en lecture seule.

La méthode·EventDispatcher.dispatchEvent() ne s'applique pas aux objets LoaderInfo. Si vous appelez dispatchEvent() sur un objet LoaderInfo, une exception IllegalOperationError est renvoyée.

Consulter les exemples

Voir aussi

flash.display.Loader
flash.display.Loader.content
flash.display.DisplayObject
flash.display.DisplayObject.loaderInfo
Suivi de la progression du chargement.


Propriétés publiques
 PropriétéDéfini par
  actionScriptVersion : uint
[lecture-seule] Version ActionScript du fichier SWF chargé.
LoaderInfo
  applicationDomain : ApplicationDomain
[lecture-seule] Lorsqu’un fichier SWF externe est chargé, toutes les définitions ActionScript 3.0 que contient la classe chargée sont enregistrées dans la propriété applicationDomain.
LoaderInfo
  bytes : ByteArray
[lecture-seule] Octets associés à un objet LoaderInfo.
LoaderInfo
  bytesLoaded : uint
[lecture-seule] Nombre d’octets chargés pour le média.
LoaderInfo
  bytesTotal : uint
[lecture-seule] Nombre d'octets compressés du fichier multimédias entier.
LoaderInfo
  childAllowsParent : Boolean
[lecture-seule] Exprime la relation de confiance qui lie le contenu (l’enfant) à l’objet Loader (le parent).
LoaderInfo
 Inheritedconstructor : 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] Objet chargé associé à cet objet LoaderInfo.
LoaderInfo
  contentType : String
[lecture-seule] Type MIME du fichier chargé.
LoaderInfo
  frameRate : Number
[lecture-seule] Cadence d’images nominale, en images par seconde, du fichier SWF chargé.
LoaderInfo
  height : int
[lecture-seule] Hauteur nominale du fichier chargé.
LoaderInfo
  loader : Loader
[lecture-seule] Objet Loader associé à cet objet LoaderInfo.
LoaderInfo
  loaderURL : String
[lecture-seule] URL du fichier SWF qui a initié le chargement du média décrit par l’objet LoaderInfo.
LoaderInfo
  parameters : Object
[lecture-seule] Objet contenant des paires nom-valeur qui représentent les paramètres fournis au fichier SWF chargé.
LoaderInfo
  parentAllowsChild : Boolean
[lecture-seule] Exprime la relation de confiance qui lie l’objet Loader (le parent) au contenu (l’enfant).
LoaderInfo
 Inheritedprototype : Object
[static] Référence à l’objet prototype d’un objet de classe ou fonction.
Object
  sameDomain : Boolean
[lecture-seule] Exprime la relation entre les domaines de l'objet loader et du contenu : true s'ils proviennent du même domaine ; false dans tous les autres cas.
LoaderInfo
  sharedEvents : EventDispatcher
[lecture-seule] Occurrence de EventDispatcher permettant d’échanger des événements hors des limites de sécurité.
LoaderInfo
  swfVersion : uint
[lecture-seule] Version du format du fichier SWF chargé.
LoaderInfo
  url : String
[lecture-seule] URL du média en cours de chargement.
LoaderInfo
  width : int
[lecture-seule] Largeur nominale du contenu chargé.
LoaderInfo
Méthodes publiques
 MéthodeDéfini par
 Inherited
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
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
  
[static] Renvoie l'objet LoaderInfo associé à un fichier SWF défini sous forme d'objet.
LoaderInfo
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l'objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l'objet spécifié.
Object
 Inherited
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
 Evénement Synthèse Défini par
 Inherited Distribué lorsque Flash Player a le focus du système d’exploitation et devient actif.EventDispatcher
   Distribué lorsque le chargement de données aboutit.LoaderInfo
 Inherited Distribué lorsque Flash Player perd le focus du système d’exploitation et devient inactif.EventDispatcher
   Distribué lorsqu'une requête réseau est envoyée via HTTP et que Flash Player peut détecter le code d’état HTTP.LoaderInfo
   Distribué lorsqu’il est possible d’accéder aux propriétés et aux méthodes d’un fichier SWF chargé.LoaderInfo
   Distribué lorsqu'il se produit une erreur d'entrée ou de sortie entraînant l’échec d’une opération de chargement.LoaderInfo
   Distribué lors du démarrage d’une opération de chargement.LoaderInfo
   Distribué lors de la réception des données au fur et à mesure du téléchargement.LoaderInfo
   Distribué par un objet LoaderInfo lorsqu'un objet chargé est supprimé à l'aide de la méthode unload() de l'objet Loader ou lorsqu'un second chargement est effectué par le même objet Loader et que le contenu d'origine est supprimé avant le début du chargement.LoaderInfo
Détails des propriétés
actionScriptVersionpropriété
actionScriptVersion:uint  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Version ActionScript du fichier SWF chargé. La version du langage est spécifiée par le biais des énumérations de la classe ActionScriptVersion, telles que ActionScriptVersion.ACTIONSCRIPT2 et ActionScriptVersion.ACTIONSCRIPT3.

Remarque : cette propriété possède toujours la valeur ActionScriptVersion.ACTIONSCRIPT2 ou ActionScriptVersion.ACTIONSCRIPT3. ActionScript 1.0 et 2.0 correspondent tous deux à ActionScriptVersion.ACTIONSCRIPT2 (version 2.0). Cette propriété se contente de distinguer ActionScript 1.0 et 2.0 d’ActionScript 3.0.


Implémentation
    public function get actionScriptVersion():uint

Lance
Error — Si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
 
Error — Si le fichier n’est pas un fichier SWF.

Voir aussi

applicationDomainpropriété 
applicationDomain:ApplicationDomain  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Lorsqu’un fichier SWF externe est chargé, toutes les définitions ActionScript 3.0 que contient la classe chargée sont enregistrées dans la propriété applicationDomain.

L’ensemble du code d’un fichier SWF est défini de sorte à exister dans un domaine d’application. Votre application principale s’exécute dans le domaine d’application en cours. Le domaine du système contient tous les domaines d’application, y compris le domaine en cours ; il contient donc toutes les classes Flash Player.

A l’exception du domaine du système, tous les domaines d’application sont associés à un domaine du parent. Le domaine du parent de la propriété applicationDomain de votre application principale est le domaine système. Les classes chargées ne sont définies que si leur parent ne les définit pas encore. Vous ne pouvez pas remplacer une définition de classe chargée par une définition plus récente.

Pour obtenir des exemples d’utilisation de domaines d’application, consultez le chapitre « Environnement du système client » du manuel Programmation d’ActionScript 3.0.


Implémentation
    public function get applicationDomain():ApplicationDomain

Lance
SecurityError — Ce sandbox de sécurité de l’appelant n’est pas autorisé à accéder à la propriété ApplicationDomain.

Voir aussi

bytespropriété 
bytes:ByteArray  [lecture-seule]

Version du langage : ActionScript 3.0

Octets associés à un objet LoaderInfo.


Implémentation
    public function get bytes():ByteArray

Lance
SecurityError — Si l’objet qui accède à cette API ne peut pas accéder à l’objet chargé en raison de restrictions de sécurité. Ce cas de figure se produit par exemple lorsqu’un fichier Loader tente d’accéder à la propriété contentLoaderInfo.content et n’est pas autorisé à accéder au contenu chargé.

Pour plus d’informations, consultez le chapitre « Sécurité de Flash Player » du manuel Programmation d'ActionScript 3.0.

Player Version : Flash Player 9 Mise à jour 3.

bytesLoadedpropriété 
bytesLoaded:uint  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Nombre d’octets chargés pour le média. Lorsque ce nombre atteint la valeur de bytesTotal, tous les octets sont chargés.


Implémentation
    public function get bytesLoaded():uint
bytesTotalpropriété 
bytesTotal:uint  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Nombre d'octets compressés du fichier multimédias entier.

Avant la distribution du premier événement progress par l’objet Loader correspondant de cet objet LoaderInfo, bytesTotal est défini sur 0. Après la distribution du premier événement progress par l’objet Loader, bytesTotal reflète le nombre réel d’octets à télécharger.


Implémentation
    public function get bytesTotal():uint

Voir aussi

childAllowsParentpropriété 
childAllowsParent:Boolean  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Exprime la relation de confiance qui lie le contenu (l’enfant) à l’objet Loader (le parent). Renvoie true si l’enfant a autorisé l'accès du parent, false dans le cas contraire. Cette propriété est réglée sur true si l’objet parent a appelé la méthode allowDomain() pour accorder une autorisation d'accès au domaine parent ou si un fichier de régulation interdomaine chargé dans le domaine enfant accorde une autorisation d’accès au domaine parent. Si l’enfant et le parent appartiennent au même domaine, cette propriété est réglée sur true.

Pour plus d’informations, consultez le chapitre « Sécurité de Flash Player » du manuel Programmation d'ActionScript 3.0.


Implémentation
    public function get childAllowsParent():Boolean

Lance
Error — Exception renvoyée si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
contentpropriété 
content:DisplayObject  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Objet chargé associé à cet objet LoaderInfo.


Implémentation
    public function get content():DisplayObject

Lance
SecurityError — Si l’objet qui accède à cette API ne peut pas accéder à l’objet chargé en raison de restrictions de sécurité. Ce cas de figure se produit par exemple lorsqu’un fichier Loader tente d’accéder à la propriété contentLoaderInfo.content et n’est pas autorisé à accéder au contenu chargé.

Pour plus d’informations, consultez le chapitre « Sécurité de Flash Player » du manuel Programmation d'ActionScript 3.0.

contentTypepropriété 
contentType:String  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Type MIME du fichier chargé. Le paramètre est défini sur null si le pourcentage chargé du fichier est insuffisant pour que Flash Player en détermine le type. La liste suivante répertorie les valeurs gérées :


Implémentation
    public function get contentType():String
frameRatepropriété 
frameRate:Number  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Cadence d’images nominale, en images par seconde, du fichier SWF chargé. Cette valeur correspond souvent, mais pas nécessairement, à un entier.

Elle peut être différente de la cadence d’images utilisée. Flash Player utilise la même cadence d'images pour tous les fichiers SWF chargés. Cette valeur est déterminée par la cadence d’images nominale du fichier SWF principal. Flash Player risque également de ne pas pouvoir appliquer la cadence d’images principale, en raison du matériel utilisé, de la synchronisation du son et d’autres facteurs.


Implémentation
    public function get frameRate():Number

Lance
Error — Si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
 
Error — Si le fichier n’est pas un fichier SWF.
heightpropriété 
height:int  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Hauteur nominale du fichier chargé. Elle peut être différente de la hauteur réelle du contenu affiché, car le contenu chargé ou ses objets d'affichage parent risquent d'avoir été redimensionnés.


Implémentation
    public function get height():int

Lance
Error — Si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
loaderpropriété 
loader:Loader  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Objet Loader associé à cet objet LoaderInfo. Si cet objet LoaderInfo figure dans la propriété loaderInfo de l’occurrence de la classe principale du fichier SWF, il n’est associé à aucun objet Loader.


Implémentation
    public function get loader():Loader

Lance
SecurityError — Si l’objet qui accède à cette API ne peut pas accéder à l’objet Loader en raison de restrictions de sécurité. Ce cas de figure se produit par exemple lorsqu’un fichier SWF chargé tente d’accéder à sa propriété loaderInfo.loader et n’est pas autorisé à accéder au fichier SWF en cours de chargement.

Pour plus d’informations, consultez le chapitre « Sécurité de Flash Player » du manuel Programmation d'ActionScript 3.0.

loaderURLpropriété 
loaderURL:String  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

URL du fichier SWF qui a initié le chargement du média décrit par l’objet LoaderInfo. Pour l'occurrence de la classe principale du fichier SWF, cette URL correspond à l'URL du fichier SWF.


Implémentation
    public function get loaderURL():String
parameterspropriété 
parameters:Object  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Objet contenant des paires nom-valeur qui représentent les paramètres fournis au fichier SWF chargé.

L’utilisation d’une boucle for-in vous permet d’extraire tous les noms et toutes les valeurs de l’objet parameters.

Les deux sources de paramètres sont : la chaîne de requête que contient l'URL du fichier SWF principal et la valeur du paramètre HTML FlashVars (qui n’affecte que le fichier SWF principal).

La propriété parameters remplace la technique ActionScript 1.0 et 2.0 qui consistait à utiliser des paramètres de fichier SWF en tant que propriétés du scénario principal.

La valeur de la propriété parameters est null pour les objets Loader qui contiennent des fichiers SWF qui utilisent ActionScript 1.0 ou 2.0. Elle est différente de null pour les objets Loader qui contiennent des fichiers SWF ayant recours à ActionScript 3.0.


Implémentation
    public function get parameters():Object
parentAllowsChildpropriété 
parentAllowsChild:Boolean  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Exprime la relation de confiance qui lie l’objet Loader (le parent) au contenu (l’enfant). Renvoie true si le parent a autorisé l'accès de l'enfant, false dans le cas contraire. Cette propriété est réglée sur true si l’objet parent a appelé la méthode allowDomain() pour accorder une autorisation d'accès au domaine de l'enfant ou si un fichier de régulation interdomaine chargé dans le domaine du parent accorde une autorisation d’accès au domaine de l’enfant. Si l’enfant et le parent appartiennent au même domaine, cette propriété est réglée sur true.

Pour plus d’informations, consultez le chapitre « Sécurité de Flash Player » du manuel Programmation d'ActionScript 3.0.


Implémentation
    public function get parentAllowsChild():Boolean

Lance
Error — Exception renvoyée si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
sameDomainpropriété 
sameDomain:Boolean  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Exprime la relation entre les domaines de l'objet loader et du contenu : true s'ils proviennent du même domaine ; false dans tous les autres cas.


Implémentation
    public function get sameDomain():Boolean

Lance
Error — Exception renvoyée si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
sharedEventspropriété 
sharedEvents:EventDispatcher  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Occurrence de EventDispatcher permettant d’échanger des événements hors des limites de sécurité. Même si l'élément responsable du chargement et l'élément chargé ne se font pas mutuellement confiance, ils peuvent tous deux accéder aux sharedEvents.


Implémentation
    public function get sharedEvents():EventDispatcher
swfVersionpropriété 
swfVersion:uint  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Version du format du fichier SWF chargé. Le format du fichier est spécifié par le biais des énumérations de la classe SWFVersion, telles que SWFVersion.FLASH7 et SWFVersion.FLASH9.


Implémentation
    public function get swfVersion():uint

Lance
Error — Si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
 
Error — Si le fichier n’est pas un fichier SWF.

Voir aussi

urlpropriété 
url:String  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

URL du média en cours de chargement.

Avant la distribution du premier événement progress par l’objet Loader correspondant associé à cet objet LoaderInfo, la valeur de la propriété url risque de ne refléter que l’URL initiale spécifiée par l'appel de la méthode load() de l’objet Loader. Après la distribution du premier événement progress, la propriété url reflète l’URL finale du média, suite à la résolution de toute redirection et URL relative.


Implémentation
    public function get url():String

Voir aussi

widthpropriété 
width:int  [lecture-seule]

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Largeur nominale du contenu chargé. Elle peut être différente de la largeur réelle du contenu affiché, car le contenu chargé ou ses objets d'affichage parent risquent d'avoir été redimensionnés.


Implémentation
    public function get width():int

Lance
Error — Si le pourcentage téléchargé du fichier n’est pas suffisant pour extraire les informations requises.
Détails des méthodes
getLoaderInfoByDefinition()méthode
public static function getLoaderInfoByDefinition(object:Object):LoaderInfo

Version du langage : ActionScript 3.0

Renvoie l'objet LoaderInfo associé à un fichier SWF défini sous forme d'objet.

Player Version : Flash Player 9 Mise à jour 3.

Paramètres

object:Object — Objet fichier SWF.

Valeur renvoyée
LoaderInfo — Objet LoaderInfo associé.
Détails des événements
complete Evénement
Type d'objet événement: flash.events.Event
Event.type property = flash.events.Event.COMPLETE

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Distribué lorsque le chargement de données aboutit. L’événement complete est toujours distribué après l’événement init.

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
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet réseau dont le chargement est terminé.

Voir aussi

httpStatus Evénement  
Type d'objet événement: flash.events.HTTPStatusEvent
HTTPStatusEvent.type property = flash.events.HTTPStatusEvent.HTTP_STATUS

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Distribué lorsqu'une requête réseau est envoyée via HTTP et que Flash Player peut détecter le code d’état HTTP.

Définit la valeur de la propriété type d'un objet événement httpStatus.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
statusLe code d’état HTTP renvoyé par le serveur.
targetL’objet réseau recevant un code d’état HTTP.

Voir aussi

init Evénement  
Type d'objet événement: flash.events.Event
Event.type property = flash.events.Event.INIT

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Distribué lorsqu’il est possible d’accéder aux propriétés et aux méthodes d’un fichier SWF chargé. Un objet LoaderInfo distribue l’événement init lorsque les deux conditions suivantes sont remplies :

L’événement init précède toujours l’événement complete.

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
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet LoaderInfo associé au fichier SWF en cours de chargement.

Voir aussi

ioError Evénement  
Type d'objet événement: flash.events.IOErrorEvent
IOErrorEvent.type property = flash.events.IOErrorEvent.IO_ERROR

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Distribué lorsqu'il se produit une erreur d'entrée ou de sortie entraînant l’échec d’une opération de chargement.

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

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet réseau sur lequel l’erreur d’entrée/sortie s’est produite.
textTexte à afficher en tant que message d’erreur.

Voir aussi

open Evénement  
Type d'objet événement: flash.events.Event
Event.type property = flash.events.Event.OPEN

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Distribué lors du démarrage d’une opération de chargement.

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
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet réseau qui a ouvert une connexion.

Voir aussi

progress Evénement  
Type d'objet événement: flash.events.ProgressEvent
ProgressEvent.type property = flash.events.ProgressEvent.PROGRESS

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Distribué au fur et à mesure de la réception des données via le processus de téléchargement.

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
bubblesfalse
bytesLoadedNombre d’éléments ou d’octets chargés lors du traitement de l’événement par l'écouteur.
bytesTotalNombre total d'éléments ou d'octets qui seront chargés si le processus de chargement aboutit.
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet réseau indiquant la progression.

Voir aussi

unload Evénement  
Type d'objet événement: flash.events.Event
Event.type property = flash.events.Event.UNLOAD

Version du langage : ActionScript 3.0
Version du lecteur : Flash Player 9

Distribué par un objet LoaderInfo lorsqu’un objet chargé est supprimé à l’aide de la méthode unload() de l’objet Loader ou lorsqu’un second chargement est effectué par le même objet Loader et que le contenu d’origine est supprimé avant le début du chargement.

Définit la valeur de la propriété type d'un objet événement unload.

Les propriétés de cet événement sont les suivantes :

PropriétéValeur
bubblesfalse
cancelablefalse ; il n’existe aucun comportement par défaut à annuler.
currentTargetL’objet qui traite activement l’objet Event avec un écouteur d’événements.
targetObjet LoaderInfo associé au fichier SWF en cours de déchargement ou de remplacement.

Voir aussi

Exemples Utilisation des exemples
LoaderInfoExample.as

L'exemple suivant utilise la classe LoaderInfoExample pour afficher une image sur la scène. Pour ce faire, procédez comme suit :
  1. Une propriété url est créée pour désigner l'emplacement et le nom de l'image.
  2. Le constructeur de classe crée un objet Loader appelé loader.
  3. L'objet loader crée une occurrence d'écouteur d'événements pour s'assurer que l'image se charge correctement.
  4. Le constructeur crée une occurrence d'objet URLRequest, request, et transmet le paramètre url de façon à identifier le nom de fichier et son emplacement.
  5. L'objet request est ensuite transmis à la méthode load() de l'objet loader, qui charge l'image dans la liste d'affichage.

Important : Cet exemple implique l'ajout d'un fichier appelé Image.gif dans le même répertoire que le fichier SWF compilé. Utilisez une image dont la zone corresponde aux dimensions du fichier SWF principal.

package {
    import flash.display.Loader;
    import flash.display.LoaderInfo;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.URLRequest;

    public class LoaderInfoExample extends Sprite {
        private var url:String = "Image.gif";

        public function LoaderInfoExample() {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            var request:URLRequest = new URLRequest(url);
            loader.load(request);
            addChild(loader);
        }

        private function initHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
            trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}




 

M'envoyer un message électronique lorsque des commentaires sont ajoutés à cette page | Rapport de commentaire

Page en cours: http://livedocs.adobe.com/flash/9.0_fr/ActionScriptLangRefV3/flash/display/LoaderInfo.html