Scherminhoud dynamisch laden

Met een object Loader kunt u SWF-bestanden en bestanden met afbeeldingen in een toepassing laden. De klasse Loader is een subklasse van de klasse DisplayObjectContainer. Een object Loader kan slechts één onderliggend weergaveobject in het weergaveoverzicht bevatten, namelijk het weergaveobject dat het SWF-bestand of afbeeldingsbestand vertegenwoordigt dat door het object wordt geladen. Wanneer u een object Loader aan het weergaveoverzicht toevoegt, zoals in de volgende code, voegt u ook het geladen onderliggende weergaveobject aan het weergaveoverzicht toe zodra het is geladen:

var pictLdr:Loader = new Loader(); 
var pictURL:String = "banana.jpg" 
var pictURLReq:URLRequest = new URLRequest(pictURL); 
pictLdr.load(pictURLReq); 
this.addChild(pictLdr);

Wanneer het SWF-bestand of de afbeelding is geladen, kunt u het geladen weergaveobject naar een andere weergaveobjectcontainer verplaatsen, zoals het DisplayObjectContainer-object container in dit voorbeeld:

import flash.display.*; 
import flash.net.URLRequest; 
import flash.events.Event; 
var container:Sprite = new Sprite(); 
addChild(container); 
var pictLdr:Loader = new Loader(); 
var pictURL:String = "banana.jpg" 
var pictURLReq:URLRequest = new URLRequest(pictURL); 
pictLdr.load(pictURLReq); 
pictLdr.contentLoaderInfo.addEventListener(Event.COMPLETE, imgLoaded);  
function imgLoaded(event:Event):void 
{ 
    container.addChild(pictLdr.content);  
}

Wanneer het bestand met laden begint, wordt er een object LoaderInfo gemaakt. Een object LoaderInfo biedt bijvoorbeeld informatie over de voortgang van het laden, de URL's van de lader en geladen inhoud, het totale aantal bytes voor de media en de nominale hoogte en breedte van de media. Een object LoaderInfo verzendt ook gebeurtenissen voor het controleren van de voortgang van het laden.

Het volgende diagram toont de verschillende manieren waarop het object LoaderInfo kan worden gebruikt (voor de instantie van de hoofdklasse van het SWF-bestand, voor een object Loader en voor een object dat is geladen door het object Loader):

Afbeelding groot weergeven

U hebt toegang tot het object LoaderInfo als een eigenschap van zowel het object Loader en het geladen weergaveobject. Wanneer het laden begint, hebt u toegang tot het object LoaderInfo via de eigenschap contentLoaderInfo van het object Loader. Zodra het laden van het weergaveobject is voltooid, hebt u via de eigenschap loaderInfo van het weergaveobject ook toegang tot het object LoaderInfo als een eigenschap van het geladen weergaveobject. De eigenschap loaderInfo van het geladen weergaveobject verwijst naar hetzelfde object LoaderInfo als de eigenschap contentLoaderInfo van het object Loader. Een object LoaderInfo wordt dus gedeeld tussen een geladen object en het object Loader dat het object heeft geladen (tussen lader en de geladen inhoud).

Als u toegang wilt tot de eigenschappen van de geladen inhoud, moet u een gebeurtenislistener toevoegen aan het object LoaderInfo, zoals getoond in de volgende code:

import flash.display.Loader; 
import flash.display.Sprite; 
import flash.events.Event; 
 
var ldr:Loader = new Loader(); 
var urlReq:URLRequest = new URLRequest("Circle.swf"); 
ldr.load(urlReq); 
ldr.contentLoaderInfo.addEventListener(Event.COMPLETE, loaded); 
addChild(ldr); 
 
function loaded(event:Event):void 
{ 
    var content:Sprite = event.target.content; 
    content.scaleX = 2; 
}

Zie Gebeurtenissen afhandelen voor meer informatie.

Wanneer u via de methode load() of loadBytes() van de klasse Loader een extern bestand in Flash Player of AIR laadt, kunt u eventueel een parameter context opgeven. Deze parameter is een object LoaderContext.

De klasse LoaderContext bevat drie eigenschappen waarmee u kunt definiëren hoe de geladen inhoud wordt gebruikt:

• checkPolicyFile: Gebruik deze eigenschap alleen wanneer u een afbeeldingsbestand laadt (geen SWF-bestand). Als u deze eigenschap instelt op true, controleert de Loader de oorspronkelijke server op een beleidsbestand (zie Controlemiddelen voor websites (beleidsbestanden)). Dit is alleen nodig voor inhoud afkomstig van een ander domein dan het domein van het SWF-bestand dat het object Loader bevat. Als de server bevoegdheden toekent aan het domein van Loader, heeft ActionScript in SWF-bestanden in het domein Loader toegang tot de gegevens in de geladen afbeelding. Met andere woorden, u kunt de opdracht BitmapData.draw() gebruiken om toegang te krijgen tot gegevens in de geladen afbeelding.

  Een SWF-bestand uit een ander domein dan het domein van het object Loader kan Security.allowDomain() aanroepen om een bepaald domein toe te staan.

• securityDomain: Gebruik deze eigenschap uitsluitend wanneer u een SWF-bestand laadt (geen afbeelding). Geef dit op voor een SWF-bestand uit een ander domein dan het domein van het bestand dat het object Loader bevat. Als u deze optie opgeeft, controleert Flash of er een beleidsbestand aanwezig is. Als dit er is, kunnen SWF-bestanden uit domeinen die in het domeinoverschrijdende beleidsbestand zijn toegestaan cross-scripting uitvoeren op de geladen SWF-inhoud. U kunt flash.system.SecurityDomain.currentDomain als deze parameter opgeven.

• applicationDomain: Gebruik deze eigenschap uitsluitend wanneer u een SWF-bestand laadt dat in ActionScript 3.0 is geschreven (geen afbeelding of SWF-bestand dat in ActionScript 1.0 of 2.0 is geschreven). Wanneer het bestand wordt geladen, kunt u opgeven dat het bestand in hetzelfde toepassingsdomein moet worden opgenomen als het domein van het object Loader. Dit doet u door de parameter applicationDomain in te stellen op flash.system.ApplicationDomain.currentDomain. Als u het geladen SWF-bestand in hetzelfde toepassingsdomein plaatst, hebt u direct toegang tot de klassen van het bestand. Dit kan nuttig zijn als u een SWF-bestand met ingesloten media laadt, waartoe u toegang hebt via de gekoppelde klassennamen. Zie Werken met toepassingsdomeinen voor meer informatie.

In het volgende voorbeeld ziet u hoe u naar een beleidsbestand zoekt tijdens het laden van een bitmap uit een ander domein:

var context:LoaderContext = new LoaderContext(); 
context.checkPolicyFile = true; 
var urlReq:URLRequest = new URLRequest("http://www.[your_domain_here].com/photo11.jpg"); 
var ldr:Loader = new Loader(); 
ldr.load(urlReq, context);

In het volgende voorbeeld ziet u hoe u naar een beleidsbestand zoekt tijdens het laden van een SWF-bestand uit een ander domein, zodat u het bestand in dezelfde beveiligingssandbox als het Loader-object kunt plaatsen. Bovendien voegt de code de klassen in het geladen SWF-bestand toe aan hetzelfde toepassingsdomein als het Loader-object:

var context:LoaderContext = new LoaderContext(); 
context.securityDomain = SecurityDomain.currentDomain; 
context.applicationDomain = ApplicationDomain.currentDomain; 
var urlReq:URLRequest = new URLRequest("http://www.[your_domain_here].com/library.swf"); 
var ldr:Loader = new Loader(); 
ldr.load(urlReq, context);

Zie de LoaderContext-klasse in de Naslaggids voor ActionScript 3.0 voor het Adobe Flash-platform voor meer informatie.