| Paket | fl.display |
| Klass | public class ProLoader |
| Arv | ProLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Obs! ProLoader är inte en underklass till flash.display.Loader. Om du vill använda ProLoader måste du ändra alla typreferenser till Loader till ProLoader.
ProLoader ger en jämn inläsning. Det är särskilt praktiskt med SWF-filer som använder RSL-förinläsning. SWF-filer som använder TLF-text använder till exempel RSL-förinläsning som standard. I sådana fall fördröjer ProLoaderInfo skickandet av INIT- eller COMPLETE-händelser tills RSL-förinläsningen är klar och det verkliga innehållet är tillgängligt. Följaktligen kan egenskapen content då komma åt det verkliga innehållet. Med hjälp av ProLoader kan du också undvika andra problem, som:
- Extra
addedToStage- ochremovedFromStage-händelser - Innehåll som läses in till fel överordnade objekt i bildruta ett (gäller innehåll som publiceras till Flash Player 10.2 eller senare med Flash Professional CS5.5 eller senare).
Varning! Vissa ProLoader-medlemmar har inte stöd för alla versioner av körningsmiljön. Använd bara dessa medlemmar om den publicerade AIR- eller Flash Player-versionen har stöd för dem. Annars genereras körningsfel i dessa API:er. Bland de medlemmar som har begränsat stöd för körningsmiljön finns följande metoder och egenskaper:
-
unloadAndStop() -
loadFilePromise() -
uncaughtErrorEvents
Referensavsnitten för de olika API:erna innehåller information om stöd för körningsmiljön.
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
Den aktuella hjälpmedelsimplementeringen (AccessibilityImplementation) för den här InteractiveObject-instansen. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
De nuvarande hjälpmedelsalternativen för det här visningsobjektet. | DisplayObject | |
| alpha : Number
Anger det angivna objektets alfagenomskinlighetsvärde. | DisplayObject | |
| blendMode : String
Ett värde från klassen BlendMode som anger vilket blandningsläge som ska användas. | DisplayObject | |
| blendShader : Shader [lässkyddad]
Ställer in en skuggning som används för blandning av förgrund och bakgrund. | DisplayObject | |
| buttonMode : Boolean
Anger knappläge för den här spriten. | Sprite | |
| cacheAsBitmap : Boolean
Om det är true, sparar Flash-miljöerna en intern bitmappsrepresentation av visningsobjektet i cache-minnet. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Om detta inte är null definierar det här Matrix-objektet hur ett visningsobjekt återges när cacheAsBitmap har värdet true. | DisplayObject | |
| constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| content : DisplayObject [skrivskyddad]
Innehåller rotvisningsobjektet i SWF-filen eller bildfilen (JPG, PNG eller GIF) som lästes in med metoden load() eller loadBytes(). | ProLoader | ||
| contentLoaderInfo : ProLoaderInfo [skrivskyddad]
Returnerar ett ProLoaderInfo-objekt som motsvarar det objekt som läses in. | ProLoader | ||
| contextMenu : NativeMenu
Anger vilken snabbmeny som är associerad med det här objektet. | InteractiveObject | |
| doubleClickEnabled : Boolean
Anger om det här objektet tar emot doubleClick-händelser. | InteractiveObject | |
| dropTarget : DisplayObject [skrivskyddad]
Anger det visningsobjekt som spriten dras över, eller som spriten släpptes på. | Sprite | |
| filters : Array
En indexerad array som innehåller varje filterobjekt som är associerat med visningsobjektet. | DisplayObject | |
| focusRect : Object
Anger om det här objektet visar en fokusram. | InteractiveObject | |
| graphics : Graphics [skrivskyddad]
Anger det Graphics-objekt som tillhör denna sprite där kommandon för vektorritning kan göras. | Sprite | |
| height : Number
Anger visningsobjektets höjd i pixlar. | DisplayObject | |
| hitArea : Sprite
Utser en annan sprite som ska fungera som träffområde för en sprite. | Sprite | |
| loaderInfo : LoaderInfo [skrivskyddad]
Returnerar ett LoaderInfo-objekt som innehåller information om hur filen som visningsobjektet tillhör ska läsas in. | DisplayObject | |
| mask : DisplayObject
Det anropande visningsobjektet maskeras av det angivna visningsobjektet. | DisplayObject | |
| metaData : Object
Erhåller metadataobjektet för instansen DisplayObject om metadata har lagrats tillsammans med instansen för detta DisplayObject i SWF-filen via en PlaceObject4-tagg. | DisplayObject | |
| mouseChildren : Boolean
Avgör om objektets underordnade objekt är aktiverade för en mus eller annan användarindataenhet (eller inte). | DisplayObjectContainer | |
| mouseEnabled : Boolean
Anger om det här objektet tar emot musmeddelanden eller annan indata från användaren. | InteractiveObject | |
| mouseX : Number [skrivskyddad]
Anger x-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | |
| mouseY : Number [skrivskyddad]
Anger y-koordinaten för musens eller användarens indataenhets position i pixlar. | DisplayObject | |
| name : String
Anger instansnamnet för DisplayObject. | DisplayObject | |
| needsSoftKeyboard : Boolean
Anger om ett virtuellt tangentbord (t.ex. ett skärmtangentbord) ska visas när den här InteractiveObject-instansen är i fokus. | InteractiveObject | |
| numChildren : int [skrivskyddad]
Returnerar antalet underordnade objekt det här objektet har. | DisplayObjectContainer | |
| opaqueBackground : Object
Anger om visningsobjektet är ogenomskinligt med en viss bakgrundsfärg. | DisplayObject | |
| parent : DisplayObjectContainer [skrivskyddad]
Anger DisplayObjectContainer-objektet som innehåller visningsobjektet. | DisplayObject | |
| root : DisplayObject [skrivskyddad]
För ett visningsobjekt i en inläst SWF-fil är rotegenskapen det översta visningsobjektet i den del av visningslistans trädstruktur som representeras av den SWF-filen. | DisplayObject | |
| rotation : Number
Anger DisplayObject-instansens rotation i grader från den ursprungliga orienteringen. | DisplayObject | |
| rotationX : Number
Anger x-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | |
| rotationY : Number
Anger y-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | |
| rotationZ : Number
Anger z-axelsrotationen i grader för DisplayObject-instansen, från den ursprungliga orienteringen i förhållande till den överordnade 3D-behållaren. | DisplayObject | |
| scale9Grid : Rectangle
Det skalningsrutnät som används för närvarande. | DisplayObject | |
| scaleX : Number
Anger vågrät skala (i procent) för objektet utifrån dess registreringspunkt. | DisplayObject | |
| scaleY : Number
Anger lodrät skala (i procent) för objektet utifrån dess registreringspunkt. | DisplayObject | |
| scaleZ : Number
Anger djupskala (procent) för objektet utifrån dess registreringspunkt. | DisplayObject | |
| scrollRect : Rectangle
Visningsobjektets gränser för rullningsrektangeln. | DisplayObject | |
| softKeyboard : String
Kontrollerar utseendet på skärmtangentbordet. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Definierar det område som ska behållas på skärmen när skärmtangentbordet visas (ej tillgängligt på iOS). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Styr ljudet i den här spriten. | Sprite | |
| stage : Stage [skrivskyddad]
Visningsobjektets scen. | DisplayObject | |
| tabChildren : Boolean
Avgör om objektets underordnade objekt är tabbaktiverade. | DisplayObjectContainer | |
| tabEnabled : Boolean
Anger om det här objektet inkluderas i tabbordningen. | InteractiveObject | |
| tabIndex : int
Anger tabbordningen för objekt i en SWF-fil. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [skrivskyddad]
Returnerar ett TextSnapshot-objekt för den här DisplayObjectContainer-instansen. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Ett objekt med egenskaper som gäller ett visningsobjekts matris, färgomformning och pixelgränser. | DisplayObject | |
| uncaughtErrorEvents : EventDispatcher [skrivskyddad]
Ett objekt som skickar en uncaughtError-händelse när ett ohanterat fel inträffar i koden i det här ProLoader-objektets SWF-fil. | ProLoader | ||
| useHandCursor : Boolean
Ett booleskt värde som anger om den pekande handen (handpekaren) ska visas när pekaren passerar över en sprite, vars buttonMode-egenskap är true. | Sprite | |
| visible : Boolean
Om visingsobjektet är synligt eller inte. | DisplayObject | |
| width : Number
Anger visningsobjektets bredd i pixlar. | DisplayObject | |
| x : Number
Anger x-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | DisplayObject | |
| y : Number
Anger y-koordinaten för DisplayObject-instansen i förhållande till de lokala koordinaterna för den överordnade DisplayObjectContainer. | DisplayObject | |
| z : Number
Anger z-koordinatens position längs DisplayObject-instansens z-axel i förhållande till den överordnade 3D-behållaren. | DisplayObject | |
| Metod | Definieras med | ||
|---|---|---|---|
Skapar ett ProLoader-objekt som du kan använda för att läsa in filer, t.ex. SWF-, JPEG-, GIF- eller PNG-filer. | ProLoader | ||
|
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. | DisplayObjectContainer | |
|
Lägger till en underordnad DisplayObject-instans i den här DisplayObjectContainer-instansen. | DisplayObjectContainer | |
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | EventDispatcher | |
|
Anger om säkerhetsrestriktionerna kan göra att visningsobjekt utelämnas från listan som returneras när metoden DisplayObjectContainer.getObjectsUnderPoint() anropas med den angivna punkten. | DisplayObjectContainer | |
Avbryter en load()-metodåtgärd som pågår för ProLoader-instansen. | ProLoader | ||
|
Avgör om det angivna visningsobjektet är underordnat DisplayObjectContainer-instansen eller själva instansen. | DisplayObjectContainer | |
|
Skickar en händelse till händelseflödet. | EventDispatcher | |
|
Returnerar en rektangel som definierar visningsområdets område i relation till targetCoordinateSpace-objektets koordinatsystem. | DisplayObject | |
|
Returnerar den underordnade visningsobjektsinstansen som finns vid det angivna indexvärdet. | DisplayObjectContainer | |
|
Returnerar det underordnade visningsobjektet som har ett visst namn. | DisplayObjectContainer | |
|
Returnerar indexpositionen för en underordnad DisplayObject-instans. | DisplayObjectContainer | |
|
Returnerar en array med objekt som ligger under den angivna punkten och är underordnade (eller indirekt underordnade) den här DisplayObjectContainer-instansen. | DisplayObjectContainer | |
|
Returnerar en rektangel som definierar visningsområdets gräns, baserat på koordinatsystemet som definieras av targetCoordinateSpace-parametern, exklusive eventuella linjer i former. | DisplayObject | |
|
Konverterar punktobjektet från scenens (globala) koordinater till visningsobjektets (lokala) koordinater. | DisplayObject | |
|
Konverterar en tvådimensionell punkt från scenens (globala) koordinater till ett tredimensionellt visningsobjekts (lokala) koordinater. | DisplayObject | |
|
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | |
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
|
Utvärderar begränsningsramen för visningsobjektet för att kontrollera om den överlappar eller korsar begränsningsramen för obj-visningsobjektet. | DisplayObject | |
|
Utvärderar visningsobjektet för att avgöra om det överlappar eller korsar den punkt som anges av x- och y-parametrarna. | DisplayObject | |
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
Läser in en fil av typen SWF, JPEG, progressiv JPEG, oanimerad GIF eller PNG i ett objekt som är underordnat detta ProLoader-objekt. | ProLoader | ||
Läser in från binära data i ett ByteArray-objekt. | ProLoader | ||
Läser in en IFilePromise-instans via parametern promise. | ProLoader | ||
|
Konverterar en tredimensionell punkt för det tredimensionella visningsobjektets (lokala) koordinater till en tvådimensionell punkt i scenens (globala) koordinater. | DisplayObject | |
|
Konverterar punktobjektet från visningsobjektets (lokala) koordinater till scenens (globala) koordinater. | DisplayObject | |
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
|
Tar bort den angivna underordnade DisplayObject-instansen från listan med underordnade för DisplayObjectContainer-instansen. | DisplayObjectContainer | |
|
Tar bort ett underordnat DisplayObject från den angivna indexpositionen i den underordnade listan i DisplayObjectContainer. | DisplayObjectContainer | |
|
Tar bort alla child-DisplayObject-instanser från listan med underordnade för DisplayObjectContainer-instansen. | DisplayObjectContainer | |
|
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | |
|
Visar ett virtuellt tangentbord. | InteractiveObject | |
|
Ändrar positionen för ett befintligt underordnat objekt i behållaren för visningsobjekt. | DisplayObjectContainer | |
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Gör att användaren kan dra angiven sprite. | Sprite | |
|
Låter användaren dra angiven sprite på en beröringsaktiverad enhet. | Sprite | |
|
Stoppar rekursivt tidslinjekörning av alla filmklipp vars rot är detta objekt. | DisplayObjectContainer | |
|
Avslutar metoden startDrag(). | Sprite | |
|
Avslutar metoden startTouchDrag(), som används med beröringsaktiverade enheter. | Sprite | |
|
Byter z-ordningen (framifrån och bakåt-ordning) för de två underordnade objekten. | DisplayObjectContainer | |
|
Byter z-ordningen (framifrån och bakåt-ordning) för underordnade objekt vid de två angivna indexpositionerna i listan med underordnade objekt. | DisplayObjectContainer | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
|
Returnerar det angivna objektets strängbeteckning. | Object | |
Tar bort ett underordnat objekt från det här ProLoader-objektet som har lästs in med metoden load(). | ProLoader | ||
|
Returnerar det angivna objektets primitiva värde. | Object | |
|
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher | |
content | egenskap |
content:DisplayObject [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Innehåller rotvisningsobjektet i SWF-filen eller bildfilen (JPG, PNG eller GIF) som lästes in med metoden load() eller loadBytes().
Implementering
public function get content():DisplayObjectUtlöser
SecurityError — Den inlästa SWF-filen eller bildfilen tillhör en säkerhetssandlåda som du inte har tillgång till. För en inläst SWF-fil kan du undvika denna situation genom att låta filen anropa Security.allowDomain()-metoden, eller genom att låta inläsningsfilen specificera en loaderContext-parameter med dess egenskap securityDomain satt till SecurityDomain.currentDomain när du anropar load()- eller loadBytes()-metoden.
|
contentLoaderInfo | egenskap |
contentLoaderInfo:ProLoaderInfo [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Returnerar ett ProLoaderInfo-objekt som motsvarar det objekt som läses in. ProLoaderInfo-objekt delas mellan ProLoader-objektet och det inlästa innehållsobjektet. ProLoaderInfo-objektet tillhandahåller förloppsinformation om inläsningen och statistik om den inlästa filen.
Händelser som rör inläsningen skickas av det ProLoaderInfo-objekt som egenskapen contentLoaderInfo för ProLoader-objektet refererar till. Egenskapen contentLoaderInfo anges till ett giltigt ProLoaderInfo-objekt, redan innan innehållet läses in, så att du kan lägga till händelseavlyssnare till objektet före inläsningen.
Om du vill identifiera ohanterade fel i en inläst SWF-fil använder du egenskapen ProLoader.uncaughtErrorEvents, inte egenskapen ProLoader.contentLoaderInfo.uncaughtErrorEvents.
Obs! Egenskapen contentLoaderInfo returnerar ett ProLoaderInfo-objekt. ProLoaderInfo är ingen underklass till LoaderInfo, och har således ingen implicit typkonvertering till superklassen. Se därför till att du ändrar typdeklarationerna från LoaderInfo till ProLoaderInfo.
Implementering
public function get contentLoaderInfo():ProLoaderInfouncaughtErrorEvents | egenskap |
uncaughtErrorEvents:EventDispatcher [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2.0 |
Ett objekt som skickar en uncaughtError-händelse när ett ohanterat fel inträffar i koden i det här ProLoader-objektets SWF-fil. Ett ohanterat fel inträffar när ett fel genereras utanför try..catch-block eller när ett ErrorEvent-objekt skickas utan några registrerade avlyssnare.
Den här egenskapen skapas när den SWF-fil som är associerad med det här objektet har lästs in helt. Tills dess är egenskapen uncaughtErrorEvents null. I ett projekt med endast ActionScript får du åtkomst till den här egenskapen under eller efter det att konstruktorfunktionen körts i huvudklassen för SWF-filen.
Åtkomst till den här ProLoader-egenskapen, i en spelare som saknar stöd, resulterar i ett fel. Returnerar ett EventDispatcher-objekt i stället för ett UncaughtErrorEvents-objekt för att undvika genereringsfel i spelare som inte stöds.
Implementering
public function get uncaughtErrorEvents():EventDispatcherRelaterade API-element
ProLoader | () | Konstruktor |
public function ProLoader()| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Skapar ett ProLoader-objekt som du kan använda för att läsa in filer, t.ex. SWF-, JPEG-, GIF- eller PNG-filer. Använd metoden load() för att läsa in resursen som underordnad till ProLoader-instansen. Sedan kan du lägga till ProLoader-objektet i visningslistan (till exempel genom att använda metoden addChild() för en DisplayObjectContainer-instans). Tillgången visas på scenen när den läses in.
Du kan också använda en ProLoader-instans "offlist" (utanför listan), det vill säga utan att lägga till den i en behållare för visningsobjekt i visningslistan. I det här läget kan Loader-instansen användas för att läsa in en SWF-fil som består av ett programs ytterligare moduler.
För att identifiera när SWF-filen har lästs in helt kan du använda händelserna för det ProLoaderInfo-objekt som är kopplat till egenskapen contentLoaderInfo för ProLoader-objektet. I det skedet kan koden i modulens SWF-fil köras för att initiera och starta modulen. I offlistläget kan en ProLoader-instans också användas för att läsa in en SWF-fil som innehåller komponenter eller medieresurser. Du kan även här använda händelser för ProLoaderInfo-objektet för att identifiera när komponenterna har lästs in helt. I det skedet kan programmet börja använda komponenterna och medieresurserna i SWF-filens bibliotek genom att instansiera de ActionScript 3.0-klasser som representerar dessa komponenter och resurser.
Ta reda på ett ProLoader-objekts status genom att övervaka följande händelser som ProLoaderInfo-objektet associerade med egenskapen contentLoaderInfo hos ProLoader-objektet:
- Händelse
openskickas när inläsningen börjar. - Händelse
ioErrorellersecurityErrorskickas om filen inte kan läsas in eller om ett fel uppstod under inläsningsprocessen. - Händelse
progressaktiveras kontinuerligt när filen läses in. - Händelsen
completeskickas när en fil har laddats ned helt, men innan det inlästa filmklippets metoder och egenskaper blir tillgängliga. Om den inlästa SWF-filen använder RSL-förinläsning skickas den här händelsen när RSL-förinläsningen är klar. Då är det verkliga innehållet tillgängligt i egenskapencontent. - Händelse
initskickas efter det att den inlästa SWF-filens egenskaper och metoder är tillgängliga, så att du kan börja arbeta med den inlästa SWF-filen. Denna händelse skickas före hanterarecomplete. Vid direktuppspelning av SWF-filer kan händelseinituppträda betydligt tidigare än händelsecomplete. Användiniti de flesta fall. Om den inlästa SWF-filen använder RSL-förinläsning skickas den här händelsen när RSL-förinläsningen är klar. Då är det verkliga innehållet tillgängligt i egenskapencontent.
Relaterade API-element
close | () | metod |
public function close():void| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player Player - 9 |
Avbryter en load()-metodåtgärd som pågår för ProLoader-instansen.
load | () | metod |
public function load(request:URLRequest, context:LoaderContext = null):void| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.0, Flash Player Player - 9 |
Läser in en fil av typen SWF, JPEG, progressiv JPEG, oanimerad GIF eller PNG i ett objekt som är underordnat detta ProLoader-objekt. När du läser in en animerad GIF-fil visas bara den första bildrutan. Eftersom ProLoader-objektet bara kan innehålla ett enda underordnat objekt avslutar utställandet av ytterligare en load()-begäran den föregående begäran, om den fortfarande är oavslutad, och inleder en ny inläsning.
Obs! I AIR 1.5 och Flash Player 10 är maxstorleken för en inläst bild 8 191 pixlar i bredd och höjd, och det totala antalet pixlar får inte överskrida 16 777 215 pixlar. (Om en inläst bild är 8 191 pixlar bred kan den därför bara vara 2 048 pixlar hög.) I Flash Player 9 och tidigare och i AIR 1.1 och tidigare är begränsningen 2 880 pixlar i höjd och 2 880 pixlar i bredd.
En SWF-fil eller bild som lästs in i ett ProLoader-objekt ärver positions-, rotations- och skalegenskaper för ProLoader-objektets överordnade visningsobjekt.
Använd metoden unload() om du vill ta bort filmer och bilder som lästs in med den här metoden eller avbryta en pågående inläsning.
Du kan förhindra att metoden används av en SWF-fil genom att ställa in parametern allowNetworking i object- och embed-taggarna på den HTML-sida där SWF-innehållet finns.
När du använder den här metoden bör du överväga Flash Player-säkerhetsmodellen, som behandlas i beskrivningen av klassen ProLoader.
Om du i Flash Player 10 eller senare använder en multipart-innehållstyp (till exempel ”multipart/form-data”) som innehåller en överföring (vilket indikeras av en ”filename”-parameter i ett ”content-disposition”-huvud inuti POST), gäller de säkerhetsregler som används för överföringar också för POST-åtgärden.
- POST-åtgärden måste utföras som ett svar på en användarinitierad åtgärd som exempelvis en musklickning eller en tangenttryckning.
- Om POST-åtgärden är för korsdomän (POST-målet ligger inte på samma server som SWF-filen som skickar POST-begäran), måste målservern ha en URL-policyfil som tillåter korsdomänåtkomst.
För en multipart-innehållstyp måste också syntaxen vara giltig (enligt standarden RFC2046). Om syntaxen verkar vara ogiltig, gäller samma regler för POST-åtgärden som för överföringar.
Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center.
Parametrar
request:URLRequest — Den absoluta eller relativa URL-adressen för SWF-, JPEG-, GIF- eller JPEG-filen som ska läsas in. En relativ sökväg måste vara relativ till huvud-SWF-filen. Absoluta URL-adresser måste innefatta protokollreferensen, exempelvis http:// eller file:///. Filnamn får inte innehålla enhetsspecifikationer.
| |
context:LoaderContext (default = null)
Om Fullständiga uppgifter finns i beskrivningen av egenskaperna för klass LoaderContext. |
Händelser
asyncError: — Skickas av objektet contentLoaderInfo om egenskapen LoaderContext.requestedContentParent har angetts och det inte är möjligt att lägga till det inlästa innehållet som ett underordnat objekt till angiven DisplayObjectContainer. Det här kan hända om det inlästa innehållet är en flash.display.AVM1Movie eller om anropet addChild() till requestedContentParent returnerar ett fel.
| |
complete: — Skickas av contentLoaderInfo-objektet när inläsningen av filen är klar. Händelsen complete skickas alltid efter init-händelsen.
| |
httpStatus: — Skickas av contentLoaderInfo-objektet när en nätverksbegäran görs via HTTP, och Flash Player kan identifiera HTTP-statuskoden.
| |
init: — Skickas av contentLoaderInfo-objektet när den inlästa SWF-filens egenskaper och metoder är tillgängliga. init-händelsen föregår alltid complete-händelsen.
| |
ioError: — Skickas av contentLoaderInfo-objektet när ett indata- eller utdatafel uppstår och får en inläsningsåtgärd att misslyckas.
| |
open: — Skickas av contentLoaderInfo-objektet när inläsningsåtgärden startar.
| |
progress: — Skickas av contentLoaderInfo-objektet när data tas emot under inläsningen.
| |
securityError: — Skickas av contentLoaderInfo-objektet om en SWF-fil i lokal-med-filsystem-sandlådan försöker att läsa in innehåll i lokal-med-nätverkstjänst-sandlådan eller vice versa.
| |
securityError: — Skickas av objektet contentLoaderInfo om egenskapen LoaderContext.requestedContentParent har angetts och om säkerhetssandlådan för LoaderContext.requestedContentParent inte har åtkomst till inläst SWF.
| |
unload: — Skickas av contentLoaderInfo-objektet när ett inläst objekt har tagits bort.
|
Utlöser
IOError — Egenskapen digest för objektet request är inte null. Du bör endast ange egenskapen digest för ett URLRequest-objekt när du anropar metoden URLLoader.load() när du läser in en SWZ-fil (en plattformskomponent för Adobe).
| |
SecurityError — Värdet på LoaderContext.securityDomain måste vara antingen null eller SecurityDomain.currentDomain. Det återspeglar det faktum att du bara kan placera det inlästa mediet i sin naturliga säkerhetssandlåda eller din egen (i det senare fallet krävs en policyfil).
| |
SecurityError — Lokala SWF-filer kan inte sätta LoaderContext.securityDomain till något annat än null. Det är inte tillåtet att importera icke-lokala media till en lokal sandlåda, eller att placera andra lokala media i något annat än deras naturliga sandlåda.
| |
SecurityError — Du kan inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.
| |
SecurityError — Om egenskap applicationDomain eller securityDomain för parameter context kommer från en otillåten domän.
| |
SecurityError — Om en lokal SWF-fil försöker använda egenskapen securityDomain hos parameter context.
| |
IllegalOperationError — Om egenskapen requestedContentParent för parametern context är ProLoader.
| |
IllegalOperationError — Om parametern LoaderContext.parameters är inställd till något annat än null och har vissa värden som inte är strängar (String).
|
Relaterade API-element
loadBytes | () | metod |
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | Flash Player 9, AIR 1.0, Flash Player 9 |
Läser in från binära data i ett ByteArray-objekt.
Metoden loadBytes() är asynkron. Du måste vänta på "init"-händelsen innan du kan komma åt egenskaperna för ett inläst objekt.
När du använder den här metoden bör du överväga Flash Player-säkerhetsmodellen, som behandlas i beskrivningen av klassen ProLoader.
Parametrar
bytes:ByteArray — Ett ByteArray-objekt. Innehållet i ByteArray kan vara ett av de filformat som stöds av klassen ProLoader: SWF, GIF, JPEG eller PNG.
| |
context:LoaderContext (default = null)applicationDomain-egenskap används. checkPolicyFile- och securityDomain-egenskaperna i LoaderContext-objekt används inte.
Om Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center. |
Händelser
asyncError: — Skickas av objektet contentLoaderInfo om egenskapen LoaderContext.requestedContentParent har angetts och det inte är möjligt att lägga till det inlästa innehållet som ett underordnat objekt till angiven DisplayObjectContainer. Det här kan hända om det inlästa innehållet är en flash.display.AVM1Movie eller om anropet addChild() till requestedContentParent returnerar ett fel.
| |
complete: — Skickas av contentLoaderInfo-objektet när åtgärden är klar. Händelsen complete skickas alltid efter init-händelsen.
| |
init: — Skickas av contentLoaderInfo-objektet när egenskaper och metoder för inlästa data är tillgängliga. init-händelsen föregår alltid complete-händelsen.
| |
ioError: — Skickas av contentLoaderInfo-objektet när miljön inte kan analysera data i bytearrayen.
| |
open: — Skickas av contentLoaderInfo-objektet när åtgärden startar.
| |
progress: — Skickas av contentLoaderInfo-objektet när data överförs i minnet.
| |
securityError: — Skickas av objektet contentLoaderInfo om egenskapen LoaderContext.requestedContentParent har angetts och om säkerhetssandlådan för LoaderContext.requestedContentParent inte har åtkomst till inläst SWF.
| |
unload: — Skickas av contentLoaderInfo-objektet när ett inläst objekt har tagits bort.
|
Utlöser
ArgumentError — Om egenskapen length hos ByteArray-objektet inte är större än 0.
| |
IllegalOperationError — Om checkPolicyFile- eller securityDomain-egenskapen i context-parametern inte har värdet null.
| |
IllegalOperationError — Om egenskapen requestedContentParent för parametern context är ProLoader.
| |
IllegalOperationError — Om parametern LoaderContext.parameters är inställd till något annat än null och har vissa värden som inte är strängar (String).
| |
SecurityError — Om den angivna applicationDomain-egenskapen i context-egenskapen är från en domän med nekad åtkomst.
| |
SecurityError — Du kan inte ansluta till vanligtvis reserverade portar. Du hittar en fullständig lista över spärrade portar i avsnittet ”Begränsa nätverks-API:er” i Utvecklarhandbok för Adobe ActionScript 3.0.
|
Relaterade API-element
loadFilePromise | () | metod |
public function loadFilePromise(promise:Object, context:LoaderContext = null):void| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | AIR 2.5, AIR 2.0, Flash Player 9 |
Läser in en IFilePromise-instans via parametern promise. Typen för promise-parametern använder superklassen Object i stället för IFilePromise för att undvika fel i andra spelare.
Metoden loadFilePromise tar ett IFilePromise-objekt och läser in de binära data. Om dessa data är en progressiv ström, t.ex. en videoväntan på "init"-händelsen eller progress-händelser innan det inlästa objektets egenskaper hämtas. Annars väntar du på complete-händelsen för att försäkra dig om att alla data har lästs in.
När du använder den här metoden bör du överväga Flash Player-säkerhetsmodellen, som behandlas i beskrivningen av klassen ProLoader.
Parametrar
promise:Object — Ett IFilePromise-objekt. Objektets datakälla kan vara ett av de filformat som stöds av klassen ProLoader: SWF, GIF, JPEG eller PNG.
| |
context:LoaderContext (default = null)applicationDomain-egenskap används. checkPolicyFile- och securityDomain-egenskaperna i LoaderContext-objekt används inte.
Om Mer information om säkerhet finns i avsnittet Security på Flash Player Developer Center. |
Händelser
asyncError: — Skickas av objektet contentLoaderInfo om egenskapen LoaderContext.requestedContentParent har angetts och det inte är möjligt att lägga till det inlästa innehållet som ett underordnat objekt till angiven DisplayObjectContainer. Det här kan hända om det inlästa innehållet är en flash.display.AVM1Movie eller om anropet addChild() till requestedContentParent returnerar ett fel.
| |
complete: — Skickas av contentLoaderInfo-objektet när åtgärden är klar. Händelsen complete skickas alltid efter init-händelsen.
| |
init: — Skickas av contentLoaderInfo-objektet när egenskaper och metoder för inlästa data är tillgängliga. init-händelsen föregår alltid complete-händelsen.
| |
ioError: — Skickas av contentLoaderInfo-objektet när miljön inte kan analysera data i datakällan eller om datakällans ström inte kan läsas.
| |
open: — Skickas av contentLoaderInfo-objektet när åtgärden startar.
| |
progress: — Skickas av contentLoaderInfo-objektet när data överförs i minnet.
| |
securityError: — Skickas av objektet contentLoaderInfo om egenskapen LoaderContext.requestedContentParent har angetts och om säkerhetssandlådan för LoaderContext.requestedContentParent inte har åtkomst till inläst SWF.
| |
unload: — Skickas av contentLoaderInfo-objektet när ett inläst objekt har tagits bort.
Varning! Vid försök att komma åt denna API utanför ett AIR-program genereras ett fel. |
Utlöser
IllegalOperationError — Om egenskapen requestedContentParent för parametern context är ett ProLoader-objekt.
| |
IllegalOperationError — Om parametern LoaderContext.parameters är inställd till något annat än null och har vissa värden som inte är strängar (String).
| |
ArgumentError — Om objektet IFilePromise som skickas som parameter är null
|
Relaterade API-element
unload | () | metod |
public function unload():void| Språkversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Körningsmiljöversioner: | AIR 1.0, Flash Player 9 |
Tar bort ett underordnat objekt från det här ProLoader-objektet som har lästs in med metoden load(). property för det associerade ProLoaderInfo-objektet återställs till null. Det underordnade objektet förstörs inte nödvändigtvis eftersom andra objekt kan ha referenser till det. Det är emellertid inte längre underordnat ProLoader-objektet.
Bästa praxis är att du, innan du avladdar en underordnad SWF-fil, uttryckligen stänger eventuella streamer i den underordnade SWF-filens objekt, såsom LocalConnection-, NetConnection-, NetStream- och Sound-objekt. I annat fall kan ljudet i den underordnade SWF-filen fortsätta att spelas upp, trots att den underordnade SWF-filen har avladdats. För att stänga streams i den underordnade SWF-filen lägger man till en händelseavlyssnare till den underordnade som lyssnar efter händelse unload. När det överordnade objektet anropar ProLoader.unload() skickas händelsen unload till det underordnade objektet. Den kod som följer visar hur detta kan göras:
function closeAllStreams(evt:Event) {
myNetStream.close();
mySound.close();
myNetConnection.close();
myLocalConnection.close();
}
myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);
Relaterade API-element
Tue Jun 12 2018, 01:40 PM Z