Utilisation du composant UILoader

Le composant UILoader est un conteneur qui peut afficher des fichiers SWF, JPEG, JPEG progressifs, PNG et GIF. Vous pouvez utiliser un composant UILoader chaque fois que vous devez récupérer du contenu depuis un emplacement distant et le placer dans une application Flash. Par exemple, vous pouvez utiliser ce composant pour ajouter un logo d’entreprise (fichier JPEG) dans un formulaire. Vous pouvez également employer le composant UILoader dans une application qui affiche des photos. Utilisez la méthode load() pour charger du contenu, la propriété percentLoaded pour déterminer la quantité de contenu qui a été chargée, et l’événement complete pour déterminer quand le chargement est terminé.

Vous pouvez redimensionner le contenu du composant UILoader ou le composant lui-même pour l’adapter à la taille du contenu. Par défaut, le contenu est dimensionné pour s’ajuster au composant UILoader. Vous pouvez également charger du contenu à l’exécution et surveiller la progression du chargement (même si une fois que le contenu est chargé, il est mis en mémoire cache et la progression passe donc rapidement à 100 %). Si vous spécifiez un emplacement lors du chargement du contenu dans le composant UILoader, vous devez spécifier les valeurs 0, 0 (coordonnées X et Y).

Interaction de l’utilisateur avec le composant UILoader

Un composant UILoader ne peut pas recevoir le focus. Cependant, le contenu chargé dans le composant UILoader peut accepter le focus et avoir ses propres interactions de focus. Pour plus d’informations sur le contrôle du focus, voir la classe FocusManager dans le Guide de référence d’ActionScript 3.0 pour Flash Professional et Utilisation de FocusManager .

Paramètres du composant UILoader

Dans l’Inspecteur des propriétés ou l’Inspecteur des composants, vous pouvez définir les paramètres de création suivants pour chaque occurrence du composant UILoader : autoLoad , maintainAspectRatio , source et scaleContent . A chacun de ces paramètres correspond une propriété ActionScript du même nom.

L’aperçu en direct des occurrences de UILoader reflète les modifications apportées aux paramètres dans l’Inspecteur des propriétés ou l’Inspecteur des composants pendant la programmation.

ActionScript vous permet de définir des options supplémentaires pour les occurrences de UILoader en utilisant ses méthodes, propriétés et événements. Pour plus d’informations, voir la classe UILoader dans le Guide de référence d’ActionScript 3.0 pour Flash Professional .

Création d’une application avec le composant UILoader

La procédure suivante explique comment ajouter un composant UILoader à une application pendant la programmation. Dans cet exemple, le composant charge une image GIF utilisée comme logo.

  1. Créez un document de fichier Flash (ActionScript 3.0).

  2. Faites glisser un composant UILoader du panneau Composants jusqu’à la scène.

  3. Dans l’Inspecteur des propriétés, entrez le nom d’occurrence aUI .

  4. Sélectionnez le chargeur sur la scène et dans l’Inspecteur des composants, puis entrez http://www.helpexamples.com/images/logo.gif pour le paramètre source .

Création d’une occurrence du composant UILoader à l’aide d’ActionScript

Cet exemple crée un composant UILoader à l’aide d’ActionScript et charge l’image JPEG d’une fleur. Lorsque l’événement complete se produit, il affiche le nombre d’octets chargés dans le panneau Sortie.

  1. Créez un document de fichier Flash (ActionScript 3.0).

  2. Faites glisser le composant UILoader du panneau Composants vers le panneau Bibliothèque.

  3. Ouvrez le panneau Actions, sélectionnez l’image 1 dans le scénario principal et entrez le code ActionScript suivant : 

    import fl.containers.UILoader; 
 
var aLoader:UILoader = new UILoader(); 
aLoader.source = "http://www.flash-mx.com/images/image1.jpg"; 
aLoader.scaleContent = false; 
addChild(aLoader); 
 
aLoader.addEventListener(Event.COMPLETE, completeHandler); 
function completeHandler(event:Event) { 
    trace("Number of bytes loaded: " + aLoader.bytesLoaded); 
}

  4. Choisissez Contrôle > Tester l’animation.