De component UILoader gebruiken

De component UILoader is een container die SWF-, JPEG-, progressieve JPEG-, PNG- en GIF-bestanden kan weergeven. U kunt een UILoader gebruiken wanneer u inhoud vanaf een externe locatie moet ophalen en in een Flash-toepassing moet opnemen. U zou bijvoorbeeld een UILoader kunnen gebruiken om een bedrijfslogo (JPEG-bestand) aan een formulier toe te voegen. U kunt de component UILoader ook gebruiken in een toepassing die foto’s weergeeft. Gebruik de methode load() om inhoud te laden, de eigenschap percentLoaded om te bepalen hoeveel inhoud is geladen en de gebeurtenis complete om te bepalen wanneer het laden is voltooid.

U kunt de inhoud van de UILoader schalen of de grootte van de UILoader zelf wijzigen, zodat deze bij de grootte van de inhoud past. De inhoud wordt standaard geschaald op de grootte van de UILoader. U kunt tevens inhoud laden bij uitvoering en de laadvoortgang controleren (wanneer inhoud wordt geladen nadat deze in cache is geplaatst, springt de voortgang echter snel naar 100%). Wanneer u een locatie opgeeft bij het laden van inhoud in UILoader, moet u de locatie (x- en y-coördinaten) 0, 0 opgeven.

Gebruikersinteractie met de component UILoader

Een component UILoader kan geen focus krijgen. Inhoud die in de component UILoader is geladen kan echter wel focus accepteren en eigen focusinteracties hebben. Zie de klasse FocusManager in de Naslaggids voor ActionScript 3.0 voor Adobe Flash Professional CS5 en Werken met FocusManager voor meer informatie over focusbeheer.

Parameters van de component UILoader

U kunt in Eigenschapcontrole of Componentcontrole de volgende ontwerpparameters instellen voor elke instantie van de component UILoader: autoLoad , maintainAspectRatio , source en scaleContent . Elk van deze parameters heeft een bijbehorende ActionScript-eigenschap met dezelfde naam.

Een live voorvertoning van elke instantie UILoader geeft direct wijzigingen weer in parameters in Eigenschapcontrole of Componentcontrole tijdens het ontwerpen.

U kunt ActionScript-code schrijven om aanvullende opties voor instanties UILoader in te stellen met de methoden, eigenschappen en gebeurtenissen ervan. Zie de klasse UILoader in de Naslaggids voor ActionScript 3.0 voor Adobe Flash Professional CS5 voor meer informatie.

Een toepassing maken met de component UILoader

De volgende procedure laat zien hoe u een component UILoader tijdens het ontwerpen aan een toepassing kunt toevoegen. In dit voorbeeld laadt de UILoader een GIF-afbeelding van een logo.

  1. Maak een nieuw Flash-document (ActionScript 3.0).

  2. Sleep een component UILoader van het deelvenster Componenten naar het werkgebied.

  3. Voer in Eigenschapcontrole de instantienaam aUI in.

  4. Selecteer de UILoader in het werkgebied en in Componentcontrole en voer http://www.helpexamples.com/images/logo.gif in bij parameter source .

Een componentinstantie UILoader met ActionScript maken

In dit voorbeeld wordt met ActionScript een component UILoader gemaakt en wordt een JPEG-afbeelding van een bloem geladen. Wanneer de gebeurtenis complete plaatsvindt, wordt het aantal geladen bytes in het deelvenster Uitvoer weergegeven.

  1. Maak een nieuw Flash-document (ActionScript 3.0).

  2. Sleep de component UILoader van het deelvenster Componenten naar het deelvenster Bibliotheek.

  3. Open het deelvenster Handelingen, selecteer frame 1 van de hoofdtijdlijn en voeg de volgende ActionScript-code toe: 

    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. Selecteer Besturing > Film testen.