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.

Voir aussi

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 actuel et toutes les classes utilisées par Flash Player ou Adobe AIR.

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 avec ActionScript 3.0.

Voir aussi

Octets associés à un objet LoaderInfo.

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

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.

Voir aussi

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 définie sur true si l'objet enfant a appelé la méthode allowDomain() pour accorder une autorisation d'accès au domaine parent, ou si un fichier de régulation d'URL 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 avec ActionScript 3.0.

Un objet qui peut être défini par le code du contenu chargé pour exposer des propriétés et des méthodes auxquelles le code dans le sandbox de l'objet Loader peut accéder. Ce pont de sandboxpermet au contenu d'un domaine qui n'est pas un domaine d'application de bénéficier d'un accès contrôlé aux scripts dans le sandbox de l'application AIR, et vice-versa. Le pont de sandbox sert de passerelle entre les sandboxes, fournissant une interaction explicite entre les sandboxes de sécurité de l'application et les autres.

Voir aussi

Objet chargé associé à cet objet LoaderInfo.

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

• "application/x-shockwave-flash"
• "image/jpeg"
• "image/gif"
• "image/png"

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 ou Adobe AIR 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. De même, la cadence d'images principale risque de ne pas pouvoir être atteinte, selon le matériel, la synchronisation du son, et d'autres facteurs.

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.

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.

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.

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.

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 définie sur true si l'objet parent a appelé la méthode allowDomain() pour accorder une autorisation d'accès au domaine enfant, ou si un fichier de régulation d'URL chargé dans le domaine parent accorde une autorisation d'accès au domaine 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 avec ActionScript 3.0.

Un objet qui peut être défini par le code dans le sandbox de l'objet Loader pour exposer les propriétés et les méthodes auxquelles le code du contenu chargé peut accéder. Ce pont de sandboxpermet au contenu d'un domaine qui n'est pas un domaine d'application de bénéficier d'un accès contrôlé aux scripts dans le sandbox de l'application AIR, et vice-versa. Le pont de sandbox sert de passerelle entre les sandboxes, fournissant une interaction explicite entre les sandboxes de sécurité de l'application et les autres.

Voir aussi

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.

Occurrence de EventDispatcher permettant d’échanger des événements hors des limites de sécurité. Même lorsque l'objet Loader et le contenu chargé proviennent de domaines de sécurité qui ne s'approuvent pas, ils peuvent accéder à sharedEvents ainsi qu'envoyer et recevoir des événements via cet objet.

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.

Voir aussi

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.

Voir aussi

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.

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

Paramètres

Distribué lorsque le chargement de données aboutit. En d'autres termes, il est distribué lorsque tout le contenu a été téléchargé et une fois le chargement terminé. L'événement complete est toujours distribué après l'événement init. L'événement init est distribué lorsque vous pouvez accéder à l'objet, même si le contenu est en cours de téléchargement.

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

Voir aussi

Distribué lorsqu'une requête réseau est effectuée sur HTTP et qu'un code d'état HTTP peut être détecté.

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

Voir aussi

Distribué lorsqu'il est possible d'accéder aux propriétés et aux méthodes d'un fichier SWF chargé et de les utiliser. Il est néanmoins toujours possible de télécharger le contenu. Un objet LoaderInfo distribue l'événement init lorsque les conditions suivantes sont remplies :

• Il est possible d'accéder à toutes les propriétés et méthodes associées à l'objet chargé et celles associées à l'objet LoaderInfo.
• L'exécution des constructeurs de tous les objets enfants est terminée.
• Le code ActionScript contenu dans la première image du scénario principal du fichier SWF chargé a été exécuté.

Par exemple, un événement Event.INIT est distribué lorsque la première image d'un clip ou d'une animation est chargée. Vous pouvez alors accéder au clip et l'ajouter à la liste d'affichage. Il est toutefois possible que le téléchargement du clip complet soit un peu plus long. L'événement Event.COMPLETE n'est distribué que lorsque le clip complet est chargé.

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

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

Voir aussi

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

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

Voir aussi

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

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

Voir aussi

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

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

Voir aussi

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.

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

Voir aussi

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énement 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);
        }
    }
}