ProLoader  - AS3 Flash

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

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

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

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

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

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

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

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

Eléments de l’API associés

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

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

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

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

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

Eléments de l’API associés

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

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

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

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

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

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

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

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

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

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

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

Paramètres

Eléments de l’API associés

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

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

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

Paramètres

Eléments de l’API associés

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

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

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

Paramètres

Eléments de l’API associés

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

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

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

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

Eléments de l’API associés