| Pakket | fl.display |
| Klasse | public class ProLoader |
| Overerving | ProLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | AIR 1.0, Flash Player 9 |
Opmerking: ProLoader is geen subklasse van flash.display.Loader. Als u ProLoader wilt gebruiken, dient u alle Loader-typereferenties te wijzigen in ProLoader.
ProLoader zorgt voor het consistent laden van bestanden. Het is vooral handig in geval van SWF-bestanden die gebruikmaken van voorladen met RSL. SWF-bestanden die TLF-tekst gebruiken, maken standaard bijvoorbeeld gebruik van voorladen met RSL. In deze gevallen vertraagt ProLoaderInfo het verzenden van de INIT- of COMPLETE-gebeurtenissen totdat het voorladen met RSL is voltooid en echte inhoud beschikbaar is. Het resultaat is dat de eigenschap content dan toegang heeft tot echte inhoud. ProLoader kan ook helpen andere problemen te voorkomen, zoals:
- Extra
addedToStage- enremovedFromStage-gebeurtenissen - Inhoud die naar het onjuiste bovenliggende element voor frame één wordt geladen (van toepassing op inhoud die is gepubliceerd naar Flash Player 10.2 of hoger met gebruik van Flash Professional CS5.5 of hoger).
Waarschuwing Bepaalde ProLoader-leden ondersteunen niet alle runtimeversies. Benader deze leden alleen wanneer uw gepubliceerde AIR- of Flash Player-versie deze ondersteunt. Anders genereren deze API's runtimefouten. De volgende methoden en eigenschap bieden slechts beperkte ondersteuning voor de runtime:
-
unloadAndStop() -
loadFilePromise() -
uncaughtErrorEvents
Raadpleeg het referentieonderwerp voor elke API om de runtimeondersteuning ervan te controleren.
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
De huidige toegankelijkheidsimplementatie (AccessibilityImplementation) voor deze InteractiveObject-instantie. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
De huidige toegankelijkheidsopties voor dit weergaveobject. | DisplayObject | |
| alpha : Number
Geeft de alpha-transparantiewaarde van het opgegeven object aan. | DisplayObject | |
| blendMode : String
Een waarde uit de klasse BlendMode die opgeeft welke overvloeimodus moet worden gebruikt. | DisplayObject | |
| blendShader : Shader [alleen-schrijven]
Stelt de arcering in die moet worden gebruikt om voor- en achtergrond in elkaar te laten overvloeien. | DisplayObject | |
| buttonMode : Boolean
Geeft de knopmodus van deze sprite op. | Sprite | |
| cacheAsBitmap : Boolean
Indien ingesteld op true, plaatsen Flash-runtimes een interne bitmaprepresentatie van het weergaveobject in cache. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Als dit Matrix-object niet null is, definieert het hoe een weergaveobject wordt gerenderd als cacheAsBitmap wordt ingesteld op true. | DisplayObject | |
| constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| content : DisplayObject [alleen-lezen]
Bevat het hoofdweergaveobject van het SWF-bestand of afbeeldingsbestand (JPG, PNG of GIF) dat is geladen met de methoden load() of loadBytes(). | ProLoader | ||
| contentLoaderInfo : ProLoaderInfo [alleen-lezen]
Retourneert een ProLoaderInfo-object dat overeenkomt met het object dat wordt geladen. | ProLoader | ||
| contextMenu : NativeMenu
Geeft het contextmenu op dat is gekoppeld aan dit object. | InteractiveObject | |
| doubleClickEnabled : Boolean
Geeft op of dit object gebeurtenissen doubleClick ontvangt. | InteractiveObject | |
| dropTarget : DisplayObject [alleen-lezen]
Geeft het weergaveobject op waarover de sprite wordt gesleept of waarop de sprite is neergezet. | Sprite | |
| filters : Array
Een geïndexeerde array die elk filterobject bevat dat momenteel is gekoppeld aan het weergaveobject. | DisplayObject | |
| focusRect : Object
Geeft op of dit object een focusrechthoek weergeeft. | InteractiveObject | |
| graphics : Graphics [alleen-lezen]
Geeft het object Graphics op dat bij deze sprite hoort, waarbij vectortekenopdrachten kunnen optreden. | Sprite | |
| height : Number
Geeft de hoogte van het weergaveobject aan, in pixels. | DisplayObject | |
| hitArea : Sprite
Wijst een andere sprite aan als raakgebied voor een sprite. | Sprite | |
| loaderInfo : LoaderInfo [alleen-lezen]
Retourneert een object LoaderInfo dat informatie bevat over het laden van het bestand waartoe dit weergaveobject behoort. | DisplayObject | |
| mask : DisplayObject
Het aanroepende weergaveobject wordt gemaskeerd door het opgegeven object mask. | DisplayObject | |
| metaData : Object
Krijgt het metagegevensobject van de DisplayObject-instantie als de metagegevens zijn opgeslagen naast de instantie van dit DisplayObject in het SWF-bestand door een PlaceObject4-markering. | DisplayObject | |
| mouseChildren : Boolean
Bepaalt of de onderliggende elementen van het object door de muis of door een gebruikersinvoerapparaat worden ingeschakeld. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Geeft aan of dit object berichten van de muis of gebruikersinvoer ontvangt. | InteractiveObject | |
| mouseX : Number [alleen-lezen]
Geeft de x-coördinaat van de apparaatpositie van de muis of de gebruikersinvoer aan in pixels. | DisplayObject | |
| mouseY : Number [alleen-lezen]
Geeft de y-coördinaat van de apparaatpositie van de muis of de gebruikersinvoer aan in pixels. | DisplayObject | |
| name : String
Geeft de instantienaam van het DisplayObject aan. | DisplayObject | |
| needsSoftKeyboard : Boolean
Geeft aan of een virtueel toetsenbord (een softwaretoetsenbord op het scherm) moet worden weergegeven wanneer deze InteractiveObject-instantie focus krijgt. | InteractiveObject | |
| numChildren : int [alleen-lezen]
Retourneert het aantal onderliggende objecten van dit object. | DisplayObjectContainer | |
| opaqueBackground : Object
Geeft op of het weergaveobject dekkend is met een bepaalde achtergrondkleur. | DisplayObject | |
| parent : DisplayObjectContainer [alleen-lezen]
Geeft het object DisplayObjectContainer aan dat dit weergaveobject bevat. | DisplayObject | |
| root : DisplayObject [alleen-lezen]
Voor een weergaveobject in een geladen SWF-bestand is de eigenschap root het bovenste weergaveobject in het gedeelte van de boomstructuur van het weergaveoverzicht dat wordt vertegenwoordigd door dat SWF-bestand. | DisplayObject | |
| rotation : Number
Geeft de rotatie van de instantie DisplayObject vanaf de oorspronkelijke oriëntatie (in graden) aan. | DisplayObject | |
| rotationX : Number
Geeft in graden de X-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container. | DisplayObject | |
| rotationY : Number
Geeft in graden de y-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container. | DisplayObject | |
| rotationZ : Number
Geeft in graden de z-asrotatie van de DisplayObject-instantie aan ten opzichte van de 3D parent-container. | DisplayObject | |
| scale9Grid : Rectangle
Het huidige schaalraster dat wordt gebruikt. | DisplayObject | |
| scaleX : Number
Bepaalt de horizontale schaal (percentage) van het object zoals deze wordt toegepast vanuit het registratiepunt. | DisplayObject | |
| scaleY : Number
Bepaalt de verticale schaal (percentage) van een object zoals deze wordt toegepast vanuit het registratiepunt van het object. | DisplayObject | |
| scaleZ : Number
Bepaalt de diepteschaal (percentage) van een object zoals deze wordt toegepast vanuit het registratiepunt van het object. | DisplayObject | |
| scrollRect : Rectangle
De verschuivende rechthoekgrenzen van het weergaveobject. | DisplayObject | |
| softKeyboard : String
Bepaalt het uiterlijk van het schermtoetsenbord. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Definieert het gebied dat als scherm moet blijven fungeren wanneer een softwaretoetsenbord wordt weergegeven (niet beschikbaar op iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Beheert geluid binnen deze sprite. | Sprite | |
| stage : Stage [alleen-lezen]
Het werkgebied van het weergaveobject. | DisplayObject | |
| tabChildren : Boolean
Bepaalt of de onderliggende objecten van het object tabnavigatie hebben. | DisplayObjectContainer | |
| tabEnabled : Boolean
Geeft op of dit object in de tabvolgorde is opgenomen. | InteractiveObject | |
| tabIndex : int
Geeft de tabvolgorde van objecten in een SWF-bestand op. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [alleen-lezen]
Retourneert een object TextSnapshot voor deze instantie DisplayObjectContainer. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Een object met eigenschappen die betrekking hebben op de matrix van een weergaveobject, de kleurtransformatie en de pixelbeperkingen. | DisplayObject | |
| uncaughtErrorEvents : EventDispatcher [alleen-lezen]
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. | ProLoader | ||
| useHandCursor : Boolean
Een Booleaanse waarde die aangeeft of het wijzende handje wordt weergegeven wanneer de cursor wordt bewogen over een sprite waarin de eigenschap buttonMode is ingesteld op true. | Sprite | |
| visible : Boolean
Bepaalt of het weergaveobject zichtbaar is. | DisplayObject | |
| width : Number
Geeft de breedte van het weergaveobject aan, in pixels. | DisplayObject | |
| x : Number
Bepaalt de x-coördinaat van de instantie DisplayObject ten opzichte van de lokale coördinaten van de bovenliggende DisplayObjectContainer. | DisplayObject | |
| y : Number
Bepaalt de y-coördinaat van de instantie DisplayObject ten opzichte van de lokale coördinaten van de bovenliggende DisplayObjectContainer. | DisplayObject | |
| z : Number
Geeft de z-coördinaatpositie langs de z-as van de DisplayObject-instantie aan ten opzichte van de bovenliggende 3D-container. | DisplayObject | |
| Methode | Gedefinieerd door | ||
|---|---|---|---|
Hiermee wordt een object ProLoader gemaakt waarmee u bestanden kunt laden, zoals SWF-, JPEG-, GIF- of PNG-bestanden. | ProLoader | ||
|
Voegt een onderliggende instantie DisplayObject toe aan deze instantie DisplayObjectContainer. | DisplayObjectContainer | |
|
Voegt een onderliggende instantie DisplayObject toe aan deze instantie DisplayObjectContainer. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | |
|
Geeft aan of vanwege beveiligingsbeperkingen weergaveobjecten worden weggelaten uit de lijst die wordt geretourneerd wanneer de methode DisplayObjectContainer.getObjectsUnderPoint() wordt aangeroepen met het opgegeven punt. | DisplayObjectContainer | |
Hiermee wordt een bewerking met de methode load() geannuleerd die momenteel wordt uitgevoerd voor de ProLoader-instantie. | ProLoader | ||
|
Bepaalt of het opgegeven weergaveobject een onderliggend object van de instantie DisplayObjectContainer of de instantie zelf is. | DisplayObjectContainer | |
|
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | |
|
Retourneert een rechthoek die het gebied van het weergaveobject aangeeft ten opzichte van het coördinatensysteem van het object targetCoordinateSpace. | DisplayObject | |
|
Retourneert de onderliggende weergaveobjectinstantie bij de opgegeven index. | DisplayObjectContainer | |
|
Retourneert de onderliggende weergaveobjectinstantie met de opgegeven naam. | DisplayObjectContainer | |
|
Retourneert de indexpositie van een onderliggende instantie DisplayObject. | DisplayObjectContainer | |
|
Retourneert een array met objecten die zich onder het opgegeven punt bevinden en onderliggende objecten van deze instantie DisplayObjectContainer zijn (of onderliggende objecten van onderliggende objecten van die instantie). | DisplayObjectContainer | |
|
Retourneert een rechthoek die de grens van het weergaveobject aangeeft op basis van het coördinatensysteem dat wordt gedefinieerd door de paramater targetCoordinateSpace, minus enige streken op vormen. | DisplayObject | |
|
Hiermee worden de (algemene) werkgebiedcoördinaten van het object point omgezet in (lokale) objectcoördinaten. | DisplayObject | |
|
Converteert een tweedimensionaal punt van de (algemene) werkruimtecoördinaten naar (lokale) coördinaten van een driedimensionaal weergaveobject. | DisplayObject | |
|
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Evalueert het selectiekader van het weergaveobject om te zien of dit het selectiekader van het weergaveobject obj overlapt of snijdt. | DisplayObject | |
|
Hiermee wordt het weergaveobject geëvalueerd om te zien of deze een punt dat is opgegeven door de parameters x en y, overlapt of doorsnijdt. | DisplayObject | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
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. | ProLoader | ||
Wordt geladen van binaire gegevens die in een ByteArray-object zijn opgeslagen. | ProLoader | ||
Laadt een IFilePromise-instantie via de promise-parameter. | ProLoader | ||
|
Converteert een driedimensionaal punt van de (lokale) coördinaten van het driedimensionale weergaveobject naar een tweedimensionaal punt in de (algemene) werkruimtecoördinaten. | DisplayObject | |
|
Hiermee worden de (lokale) weergaveobjectcoördinaten van het object point omgezet in (algemene) werkgebiedcoördinaten. | DisplayObject | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Verwijdert de opgegeven onderliggende instantie DisplayObject uit de lijst met onderliggende objecten van de instantie DisplayObjectContainer. | DisplayObjectContainer | |
|
Verwijdert een onderliggend DisplayObject uit de opgegeven indexpositie in de lijst met onderliggende objecten van de DisplayObjectContainer. | DisplayObjectContainer | |
|
Verwijdert alle onderliggende DisplayObject-instanties uit de lijst met onderliggende objecten van de instantie DisplayObjectContainer. | DisplayObjectContainer | |
|
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | |
|
Geeft een virtueel toetsenbord weer. | InteractiveObject | |
|
Wijzigt de positie van een bestaand onderliggend object in de weergaveobjectcontainer. | DisplayObjectContainer | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Hiermee kan de gebruiker de opgegeven sprite slepen. | Sprite | |
|
Hiermee kan de gebruiker de opgegeven sprite naar een apparaat met aanraakbediening slepen. | Sprite | |
|
Stopt recursief de tijdlijnuitvoering van alle filmclips die beginnen bij dit object. | DisplayObjectContainer | |
|
Beëindigt de methode startDrag(). | Sprite | |
|
Beëindigt de startTouchDrag()-methode, voor gebruik met apparaten met aanraakbediening. | Sprite | |
|
Wisselt de z-volgorde (van voor naar achter) van de twee opgegeven onderliggende objecten om. | DisplayObjectContainer | |
|
Wisselt de z-volgorde (van voor naar achter) van de onderliggende objecten op de twee opgegeven indexposities in de lijst met onderliggende objecten om. | DisplayObjectContainer | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
Hiermee wordt een onderliggend item van dit ProLoader-object verwijderd dat met de methode load() is geladen. | ProLoader | ||
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
|
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | |
content | eigenschap |
content:DisplayObject [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | AIR 1.0, Flash Player 9 |
Bevat het hoofdweergaveobject van het SWF-bestand of afbeeldingsbestand (JPG, PNG of GIF) dat is geladen met de methoden load() of loadBytes().
Implementatie
public function get content():DisplayObjectGegenereerde uitzondering
SecurityError — Het geladen SWF-bestand of afbeeldingsbestand behoort tot een beveiligingssandbox waartoe u geen toegang hebt. Voor een geladen SWF-bestand kunt u dit voorkomen door het bestand de methode Security.allowDomain() aan te laten roepen of door het bestand dat wordt geladen een parameter loaderContext op te laten geven met de eigenschap securityDomain ingesteld op SecurityDomain.currentDomain wanneer u de methode load() of loadBytes() aanroept.
|
contentLoaderInfo | eigenschap |
contentLoaderInfo:ProLoaderInfo [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | AIR 1.0, Flash Player 9 |
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.
Implementatie
public function get contentLoaderInfo():ProLoaderInfouncaughtErrorEvents | eigenschap |
uncaughtErrorEvents:EventDispatcher [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | Flash Player 10.1, AIR 2.0 |
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.
Implementatie
public function get uncaughtErrorEvents():EventDispatcherVerwante API-elementen
ProLoader | () | Constructor |
public function ProLoader()| Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | AIR 1.0, Flash Player 9 |
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
openwordt verzonden wanneer het laden wordt gestart. - De gebeurtenis
ioErrorofsecurityErrorwordt verzonden wanneer het bestand niet kan worden geladen of wanneer tijdens het laadproces een fout is opgetreden. - De gebeurtenis
progresswordt continu geactiveerd tijdens het laden van het bestand. - De gebeurtenis
completewordt 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 decontent-eigenschap. - De gebeurtenis
initwordt 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 handlercomplete. De gebeurtenisinitkan in streaming SWF-bestanden aanzienlijk eerder plaatsvinden dan de gebeurteniscomplete. Voor de meeste toepassingen gebruikt u de handlerinit. 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 decontent-eigenschap.
Verwante API-elementen
close | () | methode |
public function close():void| Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | AIR 1.0, Flash Player Player - 9 |
Hiermee wordt een bewerking met de methode load() geannuleerd die momenteel wordt uitgevoerd voor de ProLoader-instantie.
load | () | methode |
public function load(request:URLRequest, context:LoaderContext = null):void| Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | Flash Player 9, AIR 1.0, Flash Player Player - 9 |
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
request:URLRequest — De absolute of relatieve URL van het SWF-, JPEG-, GIF- of PNG-bestand dat moet worden geladen. Een relatief pad moet relatief zijn ten opzichte van het SWF-hoofdbestand. Absolute URL’s moeten een protocolverwijzing bevatten, zoals http:// of file:///. Bestandsnamen kunnen geen schijfstationsspecificatie bevatten.
| |
context:LoaderContext (default = null)
Als de parameter Zie de beschrijving van de eigenschappen in de klasse LoaderContext voor volledige informatie. |
Gebeurtenissen
asyncError: — Verzonden door het contentLoaderInfo-object als de eigenschap LoaderContext.requestedContentParent is opgegeven en de geladen inhoud niet kan worden toegevoegd als een onderliggend item voor de opgegeven DisplayObjectContainer. Dit kan gebeuren wanneer de geladen inhoud een flash.display.AVM1Movie is, of wanneer de addChild()-aanroep naar requestedContentParent een fout veroorzaakt.
| |
complete: — Wordt verzonden door het gekoppelde contentLoaderInfo-object wanneer het laden van het bestand is voltooid. De gebeurtenis complete wordt altijd verzonden na de gebeurtenis init.
| |
httpStatus: — Wordt verzonden door het contentLoaderInfo-object wanneer een netwerkaanvraag wordt uitgevoerd via HTTP en Flash Player de HTTP-statuscode kan detecteren.
| |
init: — Wordt verzonden door het contentLoaderInfo-object wanneer de eigenschappen en methoden van het geladen SWF-bestand toegankelijk zijn. De gebeurtenis init gaat altijd vooraf aan de gebeurtenis complete.
| |
ioError: — Wordt verzonden door het contentLoaderInfo-object wanneer een invoer- of uitvoerfout optreedt die ertoe leidt dat een laadbewerking mislukt.
| |
open: — Wordt verzonden door het contentLoaderInfo-object wanneer de laadbewerking start.
| |
progress: — Wordt verzonden door het contentLoaderInfo-object wanneer de gegevens tijdens de laadbewerking worden ontvangen.
| |
securityError: — Wordt verzonden door het contentLoaderInfo-object als een SWF-bestand in de sandbox lokaal-met-bestandssysteem inhoud probeert te laden in de sandbox lokaal-met-netwerk, of andersom.
| |
securityError: — Verzonden door het contentLoaderInfo-object als de eigenschap LoaderContext.requestedContentParent is opgegeven en de beveiligingssandbox van LoaderContext.requestedContentParent geen toegang heeft tot het geladen SWF-bestand.
| |
unload: — Wordt verzonden door het contentLoaderInfo-object wanneer een geladen object wordt verwijderd.
|
Gegenereerde uitzondering
IOError — De eigenschap digest van het object request is niet null. U moet de eigenschap digest van een object URLRequest alleen instellen wanneer u tijdens het laden van een SWZ-bestand (een component van het Adobe-platform) de methode URLLoader.load() aanroept.
| |
SecurityError — De waarde van LoaderContext.securityDomain moet null of SecurityDomain.currentDomain zijn. Dit geeft aan dat u de geladen media alleen in de natuurlijke beveiligingssandbox of in uw eigen beveiligingssandbox kunt plaatsen (voor deze laatste is een beleidsbestand vereist).
| |
SecurityError — Lokale SWF-bestanden mogen LoaderContext.securityDomain alleen instellen op null. Het is niet toegestaan niet-lokale media in een lokale sandbox te importeren of andere lokale media in een andere (dan de eigen natuurlijke) sandbox te plaatsen.
| |
SecurityError — U kunt geen verbinding maken met algemeen gereserveerde poorten. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.
| |
SecurityError — Wanneer de eigenschappen applicationDomain of securityDomain van de parameter context afkomstig zijn van een domein die niet is toegestaan.
| |
SecurityError — Wanneer een lokaal SWF-bestand de eigenschap securityDomain van de parameter context probeert te gebruiken.
| |
IllegalOperationError — Als de eigenschap requestedContentParent van de parameter context een ProLoader is.
| |
IllegalOperationError — Als de parameter LoaderContext.parameters is ingesteld op een andere waarde dan null en beschikt over een aantal waarden die geen tekenreeksen zijn.
|
Verwante API-elementen
loadBytes | () | methode |
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void| Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | Flash Player 9, AIR 1.0, Flash Player 9 |
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
bytes:ByteArray — Een object ByteArray. De inhoud van het object ByteArray kan een willekeurige bestandsindeling zijn die door de klasse ProLoader wordt ondersteund: .swf, .gif, .jpeg of .png.
| |
context:LoaderContext (default = null)applicationDomain van het object LoaderContext wordt toegepast; de eigenschappen checkPolicyFile en securityDomain van het object LoaderContext zijn niet van toepassing.
Als de parameter Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center. |
Gebeurtenissen
asyncError: — Verzonden door het contentLoaderInfo-object als de eigenschap LoaderContext.requestedContentParent is opgegeven en de geladen inhoud niet kan worden toegevoegd als een onderliggend item voor de opgegeven DisplayObjectContainer. Dit kan gebeuren wanneer de geladen inhoud een flash.display.AVM1Movie is, of wanneer de addChild()-aanroep naar requestedContentParent een fout veroorzaakt.
| |
complete: — Wordt verzonden door het contentLoaderInfo-object wanneer de bewerking is voltooid. De gebeurtenis complete wordt altijd verzonden na de gebeurtenis init.
| |
init: — Wordt verzonden door het contentLoaderInfo-object wanneer de eigenschappen en methoden van de geladen gegevens toegankelijk zijn. De gebeurtenis init gaat altijd vooraf aan de gebeurtenis complete.
| |
ioError: — Wordt verzonden door het contentLoaderInfo-object wanneer de runtime de gegevens in de bytearray niet kan parseren.
| |
open: — Wordt verzonden door het contentLoaderInfo-object wanneer de bewerking start.
| |
progress: — Wordt verzonden door het contentLoaderInfo-object als gegevens in het geheugen worden overgedragen.
| |
securityError: — Verzonden door het contentLoaderInfo-object als de eigenschap LoaderContext.requestedContentParent is opgegeven en de beveiligingssandbox van LoaderContext.requestedContentParent geen toegang heeft tot het geladen SWF-bestand.
| |
unload: — Wordt verzonden door het contentLoaderInfo-object wanneer een geladen object wordt verwijderd.
|
Gegenereerde uitzondering
ArgumentError — Indien de eigenschap length van het object ByteArray niet groter dan 0 is.
| |
IllegalOperationError — Indien de eigenschap checkPolicyFile of securityDomain van de parameter context niet null is.
| |
IllegalOperationError — Als de eigenschap requestedContentParent van de parameter context een ProLoader is.
| |
IllegalOperationError — Als de parameter LoaderContext.parameters is ingesteld op een andere waarde dan null en beschikt over een aantal waarden die geen tekenreeksen zijn.
| |
SecurityError — Wanneer de opgegeven eigenschap applicationDomain van de eigenschap context uit een domein komt dat niet is toegestaan.
| |
SecurityError — U kunt geen verbinding maken met algemeen gereserveerde poorten. Zie "Netwerk-API's beperken" in de Adobe ActionScript 3.0-ontwikkelaarsgids voor een volledige lijst van geblokkeerde poorten.
|
Verwante API-elementen
loadFilePromise | () | methode |
public function loadFilePromise(promise:Object, context:LoaderContext = null):void| Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | AIR 2.5, AIR 2.0, Flash Player 9 |
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
promise:Object — Een IFilePromise-object. De databron van het object kan een willekeurige bestandsindeling zijn die door de ProLoader-klasse wordt ondersteund: swf, .gif, .jpeg of .png.
| |
context:LoaderContext (default = null)applicationDomain van het object LoaderContext wordt toegepast; de eigenschappen checkPolicyFile en securityDomain van het object LoaderContext zijn niet van toepassing.
Als de parameter Lees voor meer informatie over beveiliging het onderwerp Security in het Flash Player Developer Center. |
Gebeurtenissen
asyncError: — Verzonden door het contentLoaderInfo-object als de eigenschap LoaderContext.requestedContentParent is opgegeven en de geladen inhoud niet kan worden toegevoegd als een onderliggend item voor de opgegeven DisplayObjectContainer. Dit kan gebeuren wanneer de geladen inhoud een flash.display.AVM1Movie is, of wanneer de addChild()-aanroep naar requestedContentParent een fout veroorzaakt.
| |
complete: — Wordt verzonden door het contentLoaderInfo-object wanneer de bewerking is voltooid. De gebeurtenis complete wordt altijd verzonden na de gebeurtenis init.
| |
init: — Wordt verzonden door het contentLoaderInfo-object wanneer de eigenschappen en methoden van de geladen gegevens toegankelijk zijn. De gebeurtenis init gaat altijd vooraf aan de gebeurtenis complete.
| |
ioError: — Wordt verzonden door het contentLoaderInfo-object wanneer de gegevens in de gegevensbron niet kunnen worden geparseerd door de runtime, of wanneer de gegevensbronstroom niet kan worden gelezen.
| |
open: — Wordt verzonden door het contentLoaderInfo-object wanneer de bewerking start.
| |
progress: — Wordt verzonden door het contentLoaderInfo-object als gegevens in het geheugen worden overgedragen.
| |
securityError: — Verzonden door het contentLoaderInfo-object als de eigenschap LoaderContext.requestedContentParent is opgegeven en de beveiligingssandbox van LoaderContext.requestedContentParent geen toegang heeft tot het geladen SWF-bestand.
| |
unload: — Wordt verzonden door het contentLoaderInfo-object wanneer een geladen object wordt verwijderd.
Waarschuwing Als u toegang wilt krijgen tot deze API wanneer u zich niet in een AIR-toepassing bevindt, treedt er een fout op. |
Gegenereerde uitzondering
IllegalOperationError — Als de eigenschap requestedContentParent van de parameter context een ProLoader-object is.
| |
IllegalOperationError — Als de parameter LoaderContext.parameters is ingesteld op een andere waarde dan null en beschikt over een aantal waarden die geen tekenreeksen zijn.
| |
ArgumentError — Als het IFilePromise-object dat als parameter wordt doorgegeven de waarde null heeft.
|
Verwante API-elementen
unload | () | methode |
public function unload():void| Taalversie: | ActionScript 3.0 |
| Productversie: | Flash CS5.5 |
| Runtimeversies: | AIR 1.0, Flash Player 9 |
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
Wed Jun 13 2018, 11:42 AM Z