ProLoader  - AS3 Flash

Bevat het hoofdweergaveobject van het SWF-bestand of afbeeldingsbestand (JPG, PNG of GIF) dat is geladen met de methoden load() of loadBytes().

Retourneert een ProLoaderInfo-object dat overeenkomt met het object dat wordt geladen. ProLoaderInfo-objecten worden gedeeld door het ProLoader-object en het geladen inhoudsobject. Het ProLoaderInfo-object geeft informatie over de laadvoortgang en statistieken over het geladen bestand.

Gebeurtenissen met betrekking tot de laadbewerking worden verzonden door het ProLoaderInfo-object waarnaar de eigenschap contentLoaderInfo van het ProLoader-object verwijst. De eigenschap contentLoaderInfo wordt, zelfs voordat de inhoud is geladen, op een geldig ProLoaderInfo-object ingesteld, zodat u vóór de laadbewerking gebeurtenislisteners aan het object kunt toevoegen.

Gebruik de eigenschap ProLoader.uncaughtErrorEvents in plaats van de eigenschap ProLoader.contentLoaderInfo.uncaughtErrorEvents om niet-afgevangen fouten op te sporen die in een geladen SWF-bestand plaatsvinden.

Opmerking De eigenschap contentLoaderInfo retourneert een ProLoaderInfo-object. ProLoaderInfo is geen subklasse van LoaderInfo en geeft u dus niet het voordeel van een impliciete cast naar de superklasse. Vergeet daarom niet uw typeverklaringen te wijzigen van LoaderInfo in ProLoaderInfo.

Een object dat een uncaughtError-gebeurtenis verstuurt, wanneer er een niet-afgehandelde fout optreedt in de code in het SWF-bestand van dit ProLoader-object. Er vindt een niet-afgevangen fout plaats wanneer er een fout optreedt buiten een Poging..catch blokkeert of wanneer er een ErrorEvent-object naar niet-geregistreerde listeners wordt verstuurd.

Deze eigenschap wordt gemaakt wanneer het laden van de SWF die aan dit object is gekoppeld, is voltooid. Tot dat moment is de uncaughtErrorEvents-eigenschap null. In een project met alleen ActionScript hebt u tijdens of na het uitvoeren van de constructorfunctie van de hoofdklasse van het SWF-bestand toegang tot deze eigenschap.

Als deze ProLoader-eigenschap wordt aangeroepen in een speler die deze eigenschap niet ondersteunt, resulteert dit in een fout. Retourneert een EventDispatcher-object in plaats van een UncaughtErrorEvents-object om te voorkomen dat er fouten worden gegenereerd in spelers die de eigenschap niet ondersteunen.

Verwante API-elementen

Hiermee wordt een object ProLoader gemaakt waarmee u bestanden kunt laden, zoals SWF-, JPEG-, GIF- of PNG-bestanden. Roep de methode load() aan om het element als een onderliggend item van de instantie Loader te laden. Vervolgens kunt u het object ProLoader aan het weergaveoverzicht toevoegen (bijvoorbeeld met de methode addChild() van een instantie DisplayObjectContainer). Het element wordt tijdens het laden in het werkgebied weergegeven.

U kunt een instantie ProLoader ook buiten het weergaveoverzicht gebruiken (zonder dat u het aan de weergaveobjectcontainer in het weergaveoverzicht toevoegt). In deze modus kunt u de instantie Loader gebruiken om een SWF-bestand te laden dat aanvullende modules van een toepassing bevat.

Wanneer u wilt detecteren wanneer een SWF-bestand klaar is met laden, kunt u de gebeurtenissen van het object ProLoaderInfo gebruiken die aan de eigenschap contentLoaderInfo van het ProLoader-object zijn gekoppeld. Op dat punt kan de code in het SWF-modulebestand worden uitgevoerd om de module te starten. In de modus buiten het weergaveoverzicht kan een ProLoader-instantie ook worden gebruikt om een SWF-bestand te laden dat componenten of media-elementen bevat. U kunt de gebeurtenismeldingen van het ProLoaderInfo-object gebruiken om te detecteren wanneer de componenten klaar zijn met laden. De toepassing kan de componenten en media-elementen in de bibliotheek van het SWF-bestand dan gebruiken door de ActionScript 3.0-klassen te instantiëren die deze componenten en elementen vertegenwoordigen.

Wanneer u de status van een ProLoader-object wilt bepalen, controleert u de volgende gebeurtenissen die het ProLoaderInfo-object aan de eigenschap contentLoaderInfo van het ProLoader-object heeft gekoppeld.

• De gebeurtenis open wordt verzonden wanneer het laden wordt gestart.
• De gebeurtenis ioError of securityError wordt verzonden wanneer het bestand niet kan worden geladen of wanneer tijdens het laadproces een fout is opgetreden.
• De gebeurtenis progress wordt continu geactiveerd tijdens het laden van het bestand.
• De gebeurtenis complete wordt verzonden wanneer een bestand volledig is gedownload, maar voordat de methoden en eigenschappen van de geladen filmclip beschikbaar zijn. Als het geladen SWF-bestand gebruikmaakt van voorladen met RSL, wordt deze gebeurtenis verzonden nadat het voorladen is voltooid. Op dit punt is echte inhoud beschikbaar in de content-eigenschap.
• De gebeurtenis init wordt verzonden nadat de eigenschappen en methoden van het geladen SWF-bestand toegankelijk zijn, zodat u kunt beginnen met het manipuleren van het geladen SWF-bestand. Deze gebeurtenis wordt verzonden vóór de handler complete. De gebeurtenis init kan in streaming SWF-bestanden aanzienlijk eerder plaatsvinden dan de gebeurtenis complete. Voor de meeste toepassingen gebruikt u de handler init. Als het geladen SWF-bestand gebruikmaakt van voorladen met RSL, wordt deze gebeurtenis verzonden nadat het voorladen is voltooid. Op dit punt is echte inhoud beschikbaar in de content-eigenschap.

Verwante API-elementen

Hiermee wordt een bewerking met de methode load() geannuleerd die momenteel wordt uitgevoerd voor de ProLoader-instantie.

Laadt een SWF-bestand, JPEG-bestand, progressief JPEG-bestand, GIF-bestand zonder animatie of PNG-bestand in een object dat een onderliggend item is van dit ProLoader-object. Wanneer u een GIF-bestand met animatie laadt, wordt alleen het eerste frame weergegeven. Aangezien het ProLoader-object slechts één onderliggend item kan bevatten, wordt bij het verzenden van een volgende aanvraag load() de vorige aanvraag beëindigd (indien nog in behandeling) en wordt een nieuwe laadbewerking gestart.

Opmerking: In AIR 1.5 en Flash Player 10 is de maximale grootte voor een geladen afbeelding 8,191 pixels breed of hoog en mag het totale aantal pixels niet groter zijn dan 16,777,215 pixels. (Als een geladen afbeelding 8,191 pixels breed is, kan deze daarom slechts 2048 pixels hoog zijn.) In Flash Player 9 en lager en AIR 1.1 en lager is de maximale hoogte 2880 pixels en de maximale breedte 2880 pixels.

Een in een ProLoader-object geladen SWF-bestand of -afbeelding overerft de eigenschappen voor positie, rotatie en schaal van de bovenliggende weergaveobjecten van het ProLoader-object.

Gebruik de methode unload() om films of afbeeldingen te verwijderen die met deze methode zijn geladen of om een laadbewerking te annuleren.

U kunt voorkomen dat een SWF-bestand deze methode gebruikt door de parameter allowNetworking in te stellen van de tags object en embed op de HTML-pagina die de SWF-inhoud bevat.

Als u deze methode gebruikt, kunt u overwegen het beveiligingsmodel van Flash Player te gebruiken. Dit model wordt beschreven in de beschrijving van de ProLoader-klasse.

Als u in Flash Player 10 en hoger een multipart-inhoudstype gebruikt (bijvoorbeeld 'multipart/form-data') dat een upload bevat (aangegeven met de parameter 'bestandsnaam' in een header 'content-disposition' binnen de POST-body), gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads:

• De POST-bewerking moet worden uitgevoerd in reactie op een door de gebruiker geïnitieerde actie, zoals het klikken met de muis of het indrukken van een toets.
• Als bij de POST-bewerking verschillende domeinen betrokken zijn (het doel van de POST-bewerking bevindt zich niet op dezelfde server als het SWF-bestand dat de POST-aanvraag verstuurt), moet de doelserver een URL-beleidsbestand leveren dat interdomeintoegang toestaat.

In het geval van een multipart-inhoudstype is het ook essentieel dat de syntaxis juist is (in overeenstemming met de norm RFC2046). Als de syntaxis ongeldig lijkt te zijn, gelden voor de POST-bewerking de beveiligingsregels die van toepassing zijn op uploads.

Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center.

Parameters

Verwante API-elementen

Wordt geladen van binaire gegevens die in een ByteArray-object zijn opgeslagen.

De methode loadBytes() is asynchroon. U moet op de gebeurtenis "init" wachten voordat u de eigenschappen van een geladen object opent.

Als u deze methode gebruikt, kunt u overwegen het beveiligingsmodel van Flash Player te gebruiken. Dit model wordt beschreven in de beschrijving van de ProLoader-klasse.

Parameters

Verwante API-elementen

Laadt een IFilePromise-instantie via de promise-parameter. Het type van de promise-parameter gebruikt de Object-superklasse in plaats van IFilePromise om fouten in andere spelers te voorkomen.

De methode loadFilePromise neemt een IFilePromise-object en laadt de binaire gegevens. Als de gegevens bestaan uit een progressieve stream, zoals een video, moet u wachten op 'init' of progress-gebeurtenissen voordat u toegang krijgt tot de eigenschappen van het geladen object. U kunt ook wachten op de hele gebeurtenis. Zo weet u zeker dat de gegevens volledig zijn geladen.

Als u deze methode gebruikt, kunt u overwegen het beveiligingsmodel van Flash Player te gebruiken. Dit model wordt beschreven in de beschrijving van de ProLoader-klasse.

Parameters

Verwante API-elementen

Hiermee wordt een onderliggend item van dit ProLoader-object verwijderd dat met de methode load() is geladen. De property van het gekoppelde ProLoaderInfo-object wordt teruggezet op null. Het onderliggende item wordt niet noodzakelijkerwijs verwijderd, omdat andere objecten mogelijk verwijzingen ernaar bevatten; het is echter geen onderliggend item meer van het ProLoader-object.

Voordat u een onderliggend SWF-bestand verwijdert, kunt u het best streams in de objecten van het onderliggende SWF-bestand expliciet sluiten, zoals objecten LocalConnection, NetConnection, NetStream en Sound. Anders kan het geluid in het onderliggende SWF-bestand blijven afspelen, ook al is het onderliggende SWF-bestand verwijderd. Wanneer u streams in het onderliggende SWF-bestand wilt sluiten, voegt u een gebeurtenislistener aan het onderliggende item toe dat naar de gebeurtenis unload luistert. Wanneer het bovenliggende item ProLoader.unload() aanroept, wordt de gebeurtenis unload naar het onderliggende item verzonden. De volgende code laat zien hoe u dit kunt doen:

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

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

Verwante API-elementen