| Paket | flash.html |
| Klass | public class HTMLLoader |
| Arv | HTMLLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Underklasser | FlexHTMLLoader |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Stöd för AIR-profiler: Den här funktionen stöds på alla operativsystem för datorer, men inte på mobilenheter eller enheter med AIR for TV. Du kan testa stödet vid körning med egenskapen HTMLLoader.isSupported. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
På skrivbordsdatorer (i skrivbordsprofilerna och de utökade skrivbordsprofilerna) använder klassen HTMLLoader den interna AIR WebKit-motorn. De tillgängliga funktionerna och återgivningsutseendet är samma som för klassen StageWebView, plus en nära integration och skriptbryggning mellan ActionScript och JavaScript. Eftersom klassen StageWebView använder den systemwebbkontroll som finns i plugin-programmet Flash Player bör du inte använda StageWebView- och HTMLLoader-instanser samtidigt, då detta har odefinierade beteenden och eventuellt kan avsluta programmet.
Standarddimensionerna för ett HTMLLoader-objekt är 0 x 0 pixlar. Gör HTMLLoader-objektet synligt genom att ange egenskaperna width och height.
Maxstorleken för ett HTMLLoader-objekt är 4 096 pixlar högt och 4 096 pixlar brett. Om du ställer in width eller height för ett HTMLLoader-objekt till ett värde som överskrider 4 095 genererar HTMLLoader-objektet ett ArgumentError-undantag. (Värt att notera är att i tidigare versioner av AIR 2 var maxstorleken på HTMLLoader-objekt 2 880 pixlar.)
Obs! SWF-innehåll som bäddats in på en HTML-sida måste ha bäddats in med antingen transparent eller opaque wmode om det ska visas i ett genomskinligt fönster. Standardvärdet för wmode är window, så om du inte anger ett värde kanske inte SWF-innehållet visas. På Windows och Linux visas SWF-innehåll alltid över annat innehåll när wmode är window eller opaque. Det går inte att visa PDF-innehåll i ett genomskinligt fönster, oavsett vilken wmode-inställning som används.
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 | |
| authenticate : Boolean
Anger huruvida autentiseringsbegäranden ska hanteras (true) eller inte (false) för HTTP-begäranden som utfärdas av det här objektet. | HTMLLoader | ||
| 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 | |
| cacheResponse : Boolean
Anger huruvida data för lyckade svar ska cachelagras för HTTP-begäranden som utfärdas av det här objektet. | HTMLLoader | ||
| constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| contentHeight : Number [skrivskyddad]
Höjden i pixlar för HTML-innehållet. | HTMLLoader | ||
| contentWidth : Number [skrivskyddad]
Bredden i pixlar för HTML-innehållet. | HTMLLoader | ||
| 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 | |
| hasFocusableContent : Boolean [skrivskyddad]
Anger om något innehåll i HTMLLoader-objektet går att fokusera. | HTMLLoader | ||
| height : Number [åsidosätt]
Anger höjden på rektangeln för den HTML-arbetsyta som återges. | HTMLLoader | ||
| historyLength : uint [skrivskyddad]
Den sammanlagda längden på historiklistan, inklusive poster för bakåt och framåt. | HTMLLoader | ||
| historyPosition : uint
Den aktuella positionen i historiklistan. | HTMLLoader | ||
| hitArea : Sprite
Utser en annan sprite som ska fungera som träffområde för en sprite. | Sprite | |
| htmlHost : flash.html:HTMLHost
Det HTMLHost-objekt som används för att hantera ändringar till vissa element i användargränssnittet, till exempel egenskapen window.document.title för HTMLLoader-objektet. | HTMLLoader | ||
| idleTimeout : Number
Anger tidsgränsen för inaktivitet (i millisekunder) för HTTP-begäranden från det här objektet. | HTMLLoader | ||
| isSupported : Boolean [statisk] [skrivskyddad]
Anger om klassen HTMLLoader stöds på klientsystemet. | HTMLLoader | ||
| loaded : Boolean [skrivskyddad]
Anger om JavaScript-händelsen load som motsvarar föregående anrop till metoden load eller loadString har levererats till HTML DOM i HTMLLoader-objektet. | HTMLLoader | ||
| loaderInfo : LoaderInfo [skrivskyddad]
Returnerar ett LoaderInfo-objekt som innehåller information om hur filen som visningsobjektet tillhör ska läsas in. | DisplayObject | |
| location : String [skrivskyddad]
URL:en för det innehåll som har lästs in i HTMLLoader-objektet. | HTMLLoader | ||
| manageCookies : Boolean
Anger huruvida HTTP-protokollstacken ska hantera cookies för det här objektet. | HTMLLoader | ||
| 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 | |
| navigateInSystemBrowser : Boolean
Anger om navigering i HTML-innehållets rotram (till exempel när användaren klickar på en länk, när egenskapen window.location anges eller när window.open() anropas) resulterar i navigering i HTMLLoader-objektet (false) eller i systemets standardwebbläsare (true). | HTMLLoader | ||
| 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 | |
| paintsDefaultBackground : Boolean
Bestämmer om bakgrunden i HTMLLoader-dokumentet är ogenomskinligt vit (true) eller inte (false). | HTMLLoader | ||
| parent : DisplayObjectContainer [skrivskyddad]
Anger DisplayObjectContainer-objektet som innehåller visningsobjektet. | DisplayObject | |
| pdfCapability : int [statisk] [skrivskyddad]
Typen av PDF-stöd i användarens system, angett som ett heltalskodvärde. | HTMLLoader | ||
| placeLoadStringContentInApplicationSandbox : Boolean
Specificerar om innehåll som lästs in via metoden loadString() placeras i programsandlådan (true) eller i en icke-programsandlåda (false). | HTMLLoader | ||
| 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 | |
| runtimeApplicationDomain : ApplicationDomain
Den programdomän som ska användas för window.runtime-objektet i JavaScript-kod på HTML-sidan. | HTMLLoader | ||
| 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 | |
| scrollH : Number
Den vågräta rullningspositionen för HTML-innehållet i HTMLLoader-objektet. | HTMLLoader | ||
| scrollRect : Rectangle
Visningsobjektets gränser för rullningsrektangeln. | DisplayObject | |
| scrollV : Number
Den lodräta rullningspositionen för HTML-innehållet i HTMLLoader-objektet. | HTMLLoader | ||
| 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 | |
| swfCapability : int [statisk] [skrivskyddad]
Typen av SWF-stöd på användarens system, angett som ett heltalskodvärde. | HTMLLoader | ||
| 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 | |
| textEncodingFallback : String
Den teckenkodning som används av HTMLLoader-innehållet om ingen teckenkodning anges på en HTML-sida. | HTMLLoader | ||
| textEncodingOverride : String
Den teckenkodning som används i HTMLLoader-innehållet. Denna åsidosätter alla inställningar på HTML-sidan. | HTMLLoader | ||
| 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 | |
| useCache : Boolean
Anger huruvida den lokala cachen ska genomsökas innan HTTP-begäranden som utfärdas av det här objektet hämtar data. | HTMLLoader | ||
| 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 | |
| userAgent : String
Den användaragentsträng som ska användas i kommande innehållsbegäranden från det här HTMLLoader-objektet. | HTMLLoader | ||
| visible : Boolean
Om visingsobjektet är synligt eller inte. | DisplayObject | |
| width : Number [åsidosätt]
Anger bredden på rektangeln för den HTML-arbetsyta som återges. | HTMLLoader | ||
| window : Object [skrivskyddad]
Det globala JavaScript-objektet för innehållet som läses in i HTML-kontrollen. | HTMLLoader | ||
| 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 HTMLLoader-objekt. | HTMLLoader | ||
|
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 alla pågående inläsningar. | HTMLLoader | ||
|
Avgör om det angivna visningsobjektet är underordnat DisplayObjectContainer-instansen eller själva instansen. | DisplayObjectContainer | |
createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader [statisk]
Skapar ett nytt NativeWindow-objekt som innehåller ett HTMLLoader-objekt. | HTMLLoader | ||
|
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 historikposten vid den angivna positionen. | HTMLLoader | ||
|
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 | |
Navigerar bakåt i webbläsarhistoriken, om det är möjligt. | HTMLLoader | ||
Navigerar framåt i webbläsarhistoriken, om det är möjligt. | HTMLLoader | ||
Navigerar angivet antal steg i webbläsarhistoriken. | HTMLLoader | ||
|
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 HTMLLoader-objektet med data från den plats som anges av parametern urlRequestToLoad. | HTMLLoader | ||
Läser in HTMLLoader-objektet med HTML-innehållet som finns i HTML-strängen. | HTMLLoader | ||
|
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 | |
Läser in sidan från den aktuella platsen på nytt. | HTMLLoader | ||
|
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 | |
|
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 | |
| Händelse | Sammanfattning | Definieras med | ||
|---|---|---|---|---|
| [utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | ||
| Skickas när ett visningsobjekt läggs till i visningslistan. | DisplayObject | ||
| Skickas när ett visningsobjekt läggs till i scenens visningslista, antingen direkt eller genom tillägg av ett underträd som innehåller visningsobjektet. | DisplayObject | ||
| Skickas när användaren väljer ”Ta bort” på textinnehållsmenyn. | InteractiveObject | ||
| Skickas när en användare trycker ner och släpper upp huvudknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | ||
| Signalerar att den senaste inläsningen som begärdes av loadString- eller load-metoden har slutförts. | HTMLLoader | |||
| Skickas när en användargest utlöser den snabbmeny som är kopplad till detta interaktiva objekt i ett AIR-program. | InteractiveObject | ||
| Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Kopiera eller väljer ”Kopiera” på snabbmenyn. | InteractiveObject | ||
| Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klipp ut eller väljer Klipp ut på snabbmenyn. | InteractiveObject | ||
| [utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | ||
| Skickas när en användare trycker ner och släpper upp huvudknappen på ett pekdon två gånger i snabb följd över samma InteractiveObject när detta objekts doubleClickEnabled-flagga är satt till true. | InteractiveObject | ||
| [utsändningshändelse] Skickas när spelhuvudet går in i en ny bildruta. | DisplayObject | ||
| [utsändningshändelse] Skickas när spelhuvudet stänger den aktuella bildrutan. | DisplayObject | ||
| Skickas när ett visningsobjekt fokuserats. | InteractiveObject | ||
| Skickas när ett visningsobjekt tappar fokusering. | InteractiveObject | ||
| [utsändningshändelse] Skickas efter att konstruktorerna för bildrutevisningsobjekt har körts men innan bildruteskript har körts. | DisplayObject | ||
| Skickas när användaren skapar en kontaktpunkt längs pekytans kant med en InteractiveObject-instans (såsom att trycka längs kanten av pekytan på Siri Remote för Apple-TV). Vissa enheter kan också tolka denna kontakt som en kombination av flera pekhändelser. | InteractiveObject | ||
| Skickas när användaren trycker på två kontaktpunkter över samma InteractiveObject-instans på en beröringsaktiverad enhet (som att trycka med två fingrar och sedan släppa dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren flyttar en kontaktpunkt över InteractiveObject-instansen på en beröringsaktiverad enhet (som att flytta ett finger från vänster till höger över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren utför en rotationsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och rotera dem över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren utför en svepningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med tre fingrar och sedan flytta fingrarna parallellt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren skapar en kontaktpunkt med en InteractiveObject-instans och sedan vidrör en beröringsaktiverad enhet (som att placera flera fingrar över ett visningsobjekt för att öppna en meny och sedan använda ett finger för att peka på ett menyalternativ på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren utför en zoomningsgest vid en kontaktpunkt med en InteractiveObject-instans (som att vidröra en skärm med två fingrar och sedan snabbt sära på fingrarna över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Signalerar att den ena eller båda contentWidth och contentHeight-egenskaperna i ett TMLLoader-objekt har ändrats. | HTMLLoader | |||
| Signalerar att HTML DOM har skapats som svar på en inläsning. | HTMLLoader | |||
| Signalerar att återgivningen av innehåll i HTMLLoader-objektet är helt uppdaterad. | HTMLLoader | |||
| Den här händelsen skickas till alla klientprogram som har stöd för indata via ett redigeringsprogram för inmatningsmetoder (IME). | InteractiveObject | ||
| Skickas när användaren trycker på en tangent. | InteractiveObject | ||
| Skickas när användaren försöker att ändra fokuseringen med tangentbordsnavigering. | InteractiveObject | ||
| Skickas när användaren släpper upp en tangent. | InteractiveObject | ||
| Signalerar att egenskapen location för HTMLLoader-objektet har ändrats. | HTMLLoader | |||
| Signalerar att egenskapen location för HTMLLoader-objektet har ändrats. | HTMLLoader | |||
| Signalerar att egenskapen location för HTMLLoader-objektet är på väg att ändras. | HTMLLoader | |||
| Skickas när en användare trycker ned och släpper upp mittenknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | ||
| Skickas när en användare trycker på pekdonets mittenknapp över en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när användaren försöker att ändra fokuseringen med ett pekdon. | InteractiveObject | ||
| Skickas när en användare flyttar pekdonet när det befinner sig över ett InteractiveObject. | InteractiveObject | ||
| Skickas när användaren flyttar bort pekdonet från en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när användaren flyttar pekdonet över en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när mushjulet rullas över en InteractiveObject-instans. | InteractiveObject | ||
| Skickas av drag initiator InteractiveObject när användaren släpper dragrörelsen. | InteractiveObject | ||
| Skickas av ett InteractiveObject-målobjekt när ett objekt dras till målobjektet och dragningen har accepterats med ett anrop till DragManager.acceptDragDrop(). | InteractiveObject | ||
| Skickas av ett InteractiveObject-objekt när en dragrörelse går in i dess gränser. | InteractiveObject | ||
| Skickas av ett InteractiveObject-objekt när en dragrörelse går utanför dess gränser. | InteractiveObject | ||
| Skickas kontinuerligt av ett InteractiveObject-objekt när en dragrörelse pågår inom dess gränser. | InteractiveObject | ||
| Skickas i början av en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet. | InteractiveObject | ||
| Skickas under en dragning av det InteractiveObject-objekt som anges som dragningsinitierare i DragManager.doDrag()-anropet. | InteractiveObject | ||
| Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Klistra in eller väljer Klistra in på snabbmenyn. | InteractiveObject | ||
| Skickas när användaren sänker en aktiv penna förbi skärmens upptäcktströskel. | InteractiveObject | ||
| Skickas när användaren lyfter en aktiv penna över skärmens upptäcktströskel. | InteractiveObject | ||
| Skickas när användaren flyttar en aktiv penna över skärmen medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | ||
| Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | ||
| Skickas när användaren flyttar en aktiv penna direkt över detta InteractiveObject medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | ||
| Skickas när användaren flyttar en aktiv penna bort från detta InteractiveObject och något av dess underordnade objekt medan den behålls inom skärmens upptäcktströskel. | InteractiveObject | ||
| Skickas när användaren flyttar en aktiv penna över detta InteractiveObject från utsidan av objektets underordnade träd i visningslistan (men stannar kvar inom skärmens upptäcktströskel). | InteractiveObject | ||
| Skickas när användaren släpper knappen på pekaren efter att första ha tryckt på den över en InteractiveObject-instans och sedan flyttat pekaren bort från InteractiveObject-instansen. | InteractiveObject | ||
| Skickas när ett visningsobjekt ska tas bort från visningslistan. | DisplayObject | ||
| Skickas när ett visningsobjekt ska tas bort från visningslistan, antingen direkt eller genom borttagning av ett underträd som innehåller visningsobjektet. | DisplayObject | ||
| [utsändningshändelse] Skickas när visningslistan ska uppdateras och återges. | DisplayObject | ||
| Skickas när en användare trycker ned och släpper upp högerknappen på sitt pekdon över samma InteractiveObject. | InteractiveObject | ||
| Skickas när en användare trycker på pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när en användare släpper pekdonets knapp över en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när användaren flyttar bort pekdonet från en InteractiveObject-instans. | InteractiveObject | ||
| Skickas när användaren flyttar pekdonet över en InteractiveObject-instans. | InteractiveObject | ||
| Signalerar att egenskapen scrollH eller scrollV har ändrats av HTMLLoader-objektet. | HTMLLoader | |||
| Skickas när användaren aktiverar den plattformsspecifika tangentkombinationen för funktionen Markera allt eller väljer Markera allt på snabbmenyn. | InteractiveObject | ||
| Skickas omedelbart efter att skärmtangentbordet tas fram (visas). | InteractiveObject | ||
| Skickas omedelbart innan skärmtangentbordet tas fram (visas). | InteractiveObject | ||
| Skickas omedelbart efter att skärmtangentbordet döljs. | InteractiveObject | ||
| Skickas när värdet på objektets tabChildren-flagga ändras. | InteractiveObject | ||
| Skickas när objektets tabEnabled-flagga ändras. | InteractiveObject | ||
| Skickas när värdet på objektets tabIndex-egenskap ändras. | InteractiveObject | ||
| Skickas när användaren skriver ett eller flera texttecken. | InteractiveObject | ||
| Skickas när användaren först kontaktar en beröringsaktiverad enhet (som att vidröra en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren avslutar kontakten med en beröringsaktiverad enhet (som att lyfta fingret från en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren rör enheten och skickas kontinuerligt tills kontaktpunkten avlägsnas. | InteractiveObject | ||
| Skickas när användaren flyttar kontaktpunkten bort från en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från ett visningsobjekt till ett annat på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren flyttar kontaktpunkten över en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från en punkt utanför ett visningsobjekt till en punkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren flyttar kontaktpunkten bort från en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från ett visningsobjekt till en punkt utanför visningsobjektet på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren flyttar kontaktpunkten över en InteractiveObject-instans på en beröringsaktiverad enhet (som att dra fingret från en punkt utanför ett visningsobjekt till en punkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Skickas när användaren lyfter kontaktpunkten över samma InteractiveObject-instans där kontakten initierades på en beröringsaktiverad enhet (som att trycka med fingret och sedan släppa det vid en enda kontaktpunkt över ett visningsobjekt på en mobiltelefon eller bärbar dator med pekskärm). | InteractiveObject | ||
| Signalerar att ett ohanterat JavaScript-undantag har inträffat i HTMLLoader-objektet. | HTMLLoader | |||
authenticate | egenskap |
authenticate:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger om autentiseringsbegäranden ska hanteras (true) eller inte (false) för HTTP-begäranden som utfärdas av det här objektet. Om värdet är false returnerar autentiseringskrav ett HTTP-fel.
Standardvärdet är initialized from URLRequestDefaults.authenticate.
Implementering
public function get authenticate():Boolean public function set authenticate(value:Boolean):voidRelaterade API-element
cacheResponse | egenskap |
cacheResponse:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger huruvida data för lyckade svar ska cachelagras för HTTP-begäranden som utfärdas av det här objektet. När värdet är true använder HTMLLoader-objektet operativsystemets HTTP-cache.
Standardvärdet är initialized from URLRequestDefaults.cacheResponse.
Implementering
public function get cacheResponse():Boolean public function set cacheResponse(value:Boolean):voidRelaterade API-element
contentHeight | egenskap |
contentHeight:Number [skrivskyddad] | Körningsmiljöversioner: | AIR 1.0 |
Höjden i pixlar för HTML-innehållet. Den här egenskapen kan ändras när dimensionerna för HTMLLoader-objektet ändras. Exempelvis använder en HTML-sida ofta hela höjden för HTMLLoader-objektet, och egenskapen contentHeight kan ändras om du ändrar höjden på HTMLLoader-objektet.
Implementering
public function get contentHeight():Number contentWidth | egenskap |
contentWidth:Number [skrivskyddad] | Körningsmiljöversioner: | AIR 1.0 |
Bredden i pixlar för HTML-innehållet. Den här egenskapen kan ändras när dimensionerna för HTMLLoader-objektet ändras. Exempelvis använder en HTML-sida ofta hela bredden för HTMLLoader-objektet, och egenskapen contentWidth kan ändras om du ändrar bredden på HTMLLoader-objektet.
Implementering
public function get contentWidth():Number hasFocusableContent | egenskap |
height | egenskap |
height:Number[åsidosätt] | Körningsmiljöversioner: | AIR 1.0 |
Anger höjden på rektangeln för den HTML-arbetsyta som återges. Egenskapsvärdet är höjden på HTMLLoader-visningsobjektet i antal pixlar. Maxvärdet för height är 4 095 pixlar. Om den här egenskapen ändras återger HTMLLoader HTML-dokumentet på nytt. htmlBoundsChanged-händelser kan skickas som svar på att den här egenskapen ändras.
När du anger egenskapen width eller height för ett HTMLLoader-objekt ändras objektets gränser, men innehållet skalas inte (vilket skulle inträffa med andra typer av visningsobjekt).
Implementering
override public function get height():Number override public function set height(value:Number):void historyLength | egenskap |
historyLength:uint [skrivskyddad] | Körningsmiljöversioner: | AIR 1.0 |
Den sammanlagda längden på historiklistan, inklusive poster för bakåt och framåt. Den här egenskapen har samma värde som JavaScript-egenskapen window.history.length för HTML-sidan.
Implementering
public function get historyLength():uintRelaterade API-element
historyPosition | egenskap |
historyPosition:uint| Körningsmiljöversioner: | AIR 1.0 |
Den aktuella positionen i historiklistan. Historiklistan motsvarar HTML-sidans window.history-objekt. Poster som är mindre än den aktuella positionen är positioner "bakåt" i listan och poster som är större är "framåt". Vid försök att ange positionen efter slutet anges positionen till slutet.
Implementering
public function get historyPosition():uint public function set historyPosition(value:uint):voidRelaterade API-element
htmlHost | egenskap |
htmlHost:flash.html:HTMLHost| Körningsmiljöversioner: | AIR 1.0 |
Det HTMLHost-objekt som används för att hantera ändringar till vissa element i användargränssnittet, till exempel egenskapen window.document.title för HTMLLoader-objektet. Om du vill åsidosätta standardbeteenden för HTMLLoader-objekt skapar du en underklass till klassen HTMLHost och åsidosätter dess medlemsfunktioner för att hantera olika ändringar av användargränssnittet i HTML-innehållet.
Implementering
public function get htmlHost():flash.html:HTMLHost public function set htmlHost(value:flash.html:HTMLHost):voidRelaterade API-element
idleTimeout | egenskap |
idleTimeout:Number| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 2 |
Anger tidsgränsen för inaktivitet (i millisekunder) för HTTP-begäranden från det här objektet.
Tidsgränsen för inaktivitet är den tid som klienten väntar på ett svar från servern, efter att anslutningen har skapats, innan den överger begäran.
Standardvärdet är initialized from URLRequestDefaults.idleTimeout.
Implementering
public function get idleTimeout():Number public function set idleTimeout(value:Number):voidRelaterade API-element
isSupported | egenskap |
loaded | egenskap |
loaded:Boolean [skrivskyddad] | Körningsmiljöversioner: | AIR 1.0 |
Anger om JavaScript-händelsen load som motsvarar föregående anrop till metoden load() eller loadString() har levererats till HTML DOM i HTMLLoader-objektet. Den här egenskapen är true innan complete-händelsen skickas. Det är möjligt att den här egenskapen aldrig får värdet true. Detta inträffar i de fall då complete-händelsen aldrig skickas.
Implementering
public function get loaded():Boolean location | egenskap |
manageCookies | egenskap |
manageCookies:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger huruvida HTTP-protokollstacken ska hantera cookies för det här objektet. Om värdet är true läggs cookies till i begäran och cookies i svar registreras. När värdet är false läggs cookies inte till i begäran och cookies i svar registreras inte.
Standardvärdet är initialized from URLRequestDefaults.manageCookies.
Implementering
public function get manageCookies():Boolean public function set manageCookies(value:Boolean):voidRelaterade API-element
navigateInSystemBrowser | egenskap |
navigateInSystemBrowser:Boolean| Körningsmiljöversioner: | AIR 1.0 |
Anger om navigering i HTML-innehållets rotram (till exempel när användaren klickar på en länk, när egenskapen window.location anges eller när window.open() anropas) resulterar i navigering i HTMLLoader-objektet (false) eller i systemets standardwebbläsare (true). Ange den här egenskapen till true om du vill att all navigering ska utföras i systemets webbläsare (och inte i HTMLLoader-objektet).
Standardvärdet är false.
Implementering
public function get navigateInSystemBrowser():Boolean public function set navigateInSystemBrowser(value:Boolean):void paintsDefaultBackground | egenskap |
paintsDefaultBackground:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Bestämmer om bakgrunden i HTMLLoader-dokumentet är ogenomskinligt vit (true) eller inte (false). Om den här egenskapen har värdet false använder HTMLLoader-objektet visningsobjektsbehållaren som bakgrund för HTML-innehållet och ogenomskinligheten (alpha-värdet) för visningsobjektsbehållaren som HTML-bakgrund. Om body-elementet eller något annat element i HTML-dokumentet däremot har en ogenomskinlig bakgrundsfärg (angiven med style="background-color:gray", till exempel), använder den delen av det återgivna HTML-innehållet den angivna ogenomskinliga bakgrundsfärgen.
Implementering
public function get paintsDefaultBackground():Boolean public function set paintsDefaultBackground(value:Boolean):void pdfCapability | egenskap |
pdfCapability:int [skrivskyddad] | Körningsmiljöversioner: | AIR 1.0 |
Typen av PDF-stöd i användarens system, angett som ett heltalskodvärde. Ett HTMLLoader-objekt kan endast visa PDF-innehåll om den här egenskapen utvärderas som PDFCapability.STATUS_OK. Klassen PDFCapability definierar konstanter för möjliga värden för egenskapen pdfCapability, enligt följande:
| PDFCapability-konstant | Betydelse |
|---|---|
STATUS_OK | En tillräckligt ny version (8.1 eller senare) av Acrobat eller Adobe Reader upptäcks och PDF-innehåll kan läsas in i ett HTMLLoader-objekt.
Obs! Om användaren kör Windows och version 7.x eller senare av Acrobat eller Adobe Reader, körs i användarens system, används den versionen även om en senare version med stöd för inläsning av PDF-innehåll i ett HTMLLoader-objekt har installerats. Om värdet för egenskapen |
ERROR_INSTALLED_READER_NOT_FOUND | Ingen version av Acrobat eller Adobe Reader har upptäckts. Det går inte att visa PDF-innehåll i ett HTMLLoader-objekt. |
ERROR_INSTALLED_READER_TOO_OLD | Acrobat eller Adobe Reader har upptäckts, men versionen är för gammal. Det går inte att visa PDF-innehåll i ett HTMLLoader-objekt. |
ERROR_PREFERED_READER_TOO_OLD | En tillräckligt ny version (8.1 eller senare) av Acrobat eller Adobe Reader har upptäckts, men den version som har konfigurerats för att hantera PDF-innehåll är äldre än 8.1. Det går inte att visa PDF-innehåll i ett HTMLLoader-objekt. |
Implementering
public static function get pdfCapability():intRelaterade API-element
placeLoadStringContentInApplicationSandbox | egenskap |
placeLoadStringContentInApplicationSandbox:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.5 |
Specificerar om innehåll som lästs in via metoden loadString() placeras i programsandlådan (true) eller i en icke-programsandlåda (false).
När den här egenskapen ställs in på false placeras innehåll som läses in via metoden loadString() i en icke-programsandlåda med följande egenskaper:
- Den har tillgång till inläst innehåll från nätverket (men inte från filsystemet).
- Den kan inte läsa in data med hjälp av XMLHttpRequest.
- Egenskapen
window.locationställs in på"about:blank". - Innehållet har inte tillgång till egenskapen
window.runtime(liksom innehåll i icke-programsandlådor).
När den här egenskapen ställs in på true placeras innehåll som läses in via metoden loadString() i programsandlådan, med tillgång till egenskapen window.runtime och alla AIR-API:er. Se till att datakällan för en sträng som används i ett anrop till metoden loadString() är betrodd. Kodprogramsatserna i HTML-strängen körs med fullständig programbehörighet när den här egenskapen ställs in på true. Du bör bara ställa in den här egenskapen på true när du är säker på att strängen inte kan innehålla skadlig kod.
I program som kompileras med AIR 1.0- eller AIR 1.1-SDK:er placeras innehåll som läses in via metoden loadString() i programsandlådan.
Standardvärdet är false.
Implementering
public function get placeLoadStringContentInApplicationSandbox():Boolean public function set placeLoadStringContentInApplicationSandbox(value:Boolean):voidRelaterade API-element
runtimeApplicationDomain | egenskap |
runtimeApplicationDomain:ApplicationDomain| Körningsmiljöversioner: | AIR 1.0 |
Den programdomän som ska användas för window.runtime-objektet i JavaScript-kod på HTML-sidan.
Om värdet är null, eller om HTML-innehållet kommer från en annan säkerhetsdomän än det SWF-innehåll som innehåller HTMLLoader-objektet, använder sidan en standardprogramdomän som domän.
Implementering
public function get runtimeApplicationDomain():ApplicationDomain public function set runtimeApplicationDomain(value:ApplicationDomain):voidUtlöser
SecurityError — om ApplicationDomain-objektet inte kommer från anroparens säkerhetsdomän.
|
Relaterade API-element
scrollH | egenskap |
scrollV | egenskap |
swfCapability | egenskap |
swfCapability:int [skrivskyddad] | Körningsmiljöversioner: | AIR 2 |
Typen av SWF-stöd på användarens system, angett som ett heltalskodvärde. Ett HTMLLoader-objekt kan endast visa SWF-innehåll om den här egenskapen utvärderas som HTMLSWFCapability.STATUS_OK. Klassen HTMLSWFCapability definierar konstanter för möjliga värden för egenskapen swfCapability, enligt följande:
| Konstanten HTMLSWFCapability | Betydelse |
|---|---|
STATUS_OK | En tillräckligt ny version av Adobe Flash Player har identifierats och SWF-innehåll kan läsas in i ett HTMLLoader-objekt. |
ERROR_INSTALLED_PLAYER_NOT_FOUND | Ingen version av Adobe Flash Player kan identifieras. Det går inte att visa SWF-innehåll i ett HTMLLoader-objekt. |
ERROR_INSTALLED_PLAYER_TOO_OLD | Adobe Flash Player har identifierats, men versionen är för gammal. Det går inte att visa SWF-innehåll i ett HTMLLoader-objekt. |
Implementering
public static function get swfCapability():intRelaterade API-element
textEncodingFallback | egenskap |
textEncodingFallback:String| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Den teckenkodning som används av HTMLLoader-innehållet om ingen teckenkodning anges på en HTML-sida. En HTML-sida anger en teckenkodning i en meta-tagg, som i följande exempel:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Värdena definieras i IANA-listan över giltiga teckenuppsättningar.
Om ingen kodning anges på HTML-sidan, av egenskapen textEncodingFallback eller av egenskapen textEncodingOverride, används ISO-8859-1-kodning av HTML-innehållet.
Implementering
public function get textEncodingFallback():String public function set textEncodingFallback(value:String):voidRelaterade API-element
textEncodingOverride | egenskap |
textEncodingOverride:String| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Den teckenkodning som används i HTMLLoader-innehållet. Denna åsidosätter alla inställningar på HTML-sidan. En HTML-sida anger en teckenkodning i en meta-tagg, som i följande exempel:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Den här inställningen åsidosätter även en eventuell inställning i egenskapen textEncodingFallback.
Värdena definieras i IANA-listan över giltiga teckenuppsättningar.
Ange egenskapen textEncodingOverride efter att HTML-innehållet har lästs in, så att AIR kan uppdatera HTML-innehållet med den angivna kodningen. När HTMLLoader navigerar till en ny sida måste du ange egenskapen igen, om du vill att den nya sidan ska använda en viss kodning.
Om ingen kodning anges på HTML-sidan, av egenskapen textEncodingFallback eller av egenskapen textEncodingOverride, används ISO-8859-1-kodning av HTML-innehållet.
Om egenskapen textEncodingOverride anges till null återställs standardbeteendet.
Implementering
public function get textEncodingOverride():String public function set textEncodingOverride(value:String):voidRelaterade API-element
useCache | egenskap |
useCache:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Anger huruvida den lokala cachen ska genomsökas innan HTTP-begäranden som utfärdas av det här objektet hämtar data.
Standardvärdet är initialized from URLRequestDefaults.useCache.
Implementering
public function get useCache():Boolean public function set useCache(value:Boolean):voidRelaterade API-element
userAgent | egenskap |
userAgent:String| Körningsmiljöversioner: | AIR 1.0 |
Den användaragentsträng som ska användas i kommande innehållsbegäranden från det här HTMLLoader-objektet.
Ange användaragentsträngen genom att ange egenskapen userAgent för HTMLLoader-objektet innan metoden load() anropas. Egenskapen userAgent för det URLRequest-objekt som skickas till metoden load() används inte.
Du kan ange den standardinställda användaragentsträng som ska användas av alla HTMLLoader-objekt i en programdomän genom att ange egenskapen URLRequestDefaults.userAgent. Om inget värde anges för egenskapen userAgent för HTMLLoader (eller om värdet anges till null) anges användaragentsträngen till värdet för den statiska egenskapen URLRequestDefaults.userAgent.
Om inget värde anges, varken för egenskapen userAgent för HTMLLoader eller för URLRequestDefaults.userAgent, används ett standardvärde som användaragentsträng. Det här standardvärdet varierar beroende på körningsmiljöns operativsystem (till exempel Mac OS, Linux eller Windows), körningsmiljöns språk och körningsmiljöns version, som i följande exempel:
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, t. ex. Gecko) AdobeAIR/1.5""Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, t. ex. Gecko) AdobeAIR/1.5""Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, like Gecko) AdobeAIR/1.5"
Implementering
public function get userAgent():String public function set userAgent(value:String):voidRelaterade API-element
width | egenskap |
width:Number[åsidosätt] | Körningsmiljöversioner: | AIR 1.0 |
Anger bredden på rektangeln för den HTML-arbetsyta som återges. Detta anger bredden på HTMLLoader visningsobjekt i pixlar. Maxvärdet för width är 4 095 pixlar. Om den här egenskapen ändras återger HTMLLoader HTML-dokumentet på nytt. htmlBoundsChange-händelser kan skickas som svar på att den här egenskapen ändras. När du anger egenskaperna width och height för ett HTMLLoader-objekt ändras objektets gränser, men innehållet skalas inte (vilket skulle inträffa med andra typer av visningsobjekt).
Implementering
override public function get width():Number override public function set width(value:Number):void window | egenskap |
HTMLLoader | () | Konstruktor |
public function HTMLLoader()| Körningsmiljöversioner: | AIR 1.0 |
Skapar ett HTMLLoader-objekt.
cancelLoad | () | metod |
public function cancelLoad():void| Körningsmiljöversioner: | AIR 1.0 |
Avbryter alla pågående inläsningar.
createRootWindow | () | metod |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader| Körningsmiljöversioner: | AIR 1.0 |
Skapar ett nytt NativeWindow-objekt som innehåller ett HTMLLoader-objekt. Använd det HTMLLoader-objekt som returneras av den här metoden för att läsa in HTML-innehåll.
Som standard (om du inte anger några parametrar när den här metoden anropas) använder det nya fönstret standardsystemfärg och innehåller rullningslister för innehållet. Du kan ange parametrarna för att ändra det nya fönstrets egenskaper.
När innehållet läses in till fönstret och formateras kan mindre grafikfel uppstå. Om du vill undvika att sådan brister syns anger du parametern visible som false. När allt innehåll har hämtats till fönstret och ritats upp kan du visa det genom att ange egenskapen window.nativeWindow.visible som true eller anropa metoden window.nativeWindow.activate().
Parametrar
visible:Boolean (default = true) | |
windowInitOptions:NativeWindowInitOptions (default = null)null använder standardvärden för NativeWindowInitOptions.
| |
scrollBarsVisible:Boolean (default = true) | |
bounds:Rectangle (default = null)null anges fönstergränserna. Om något av x, y, width eller height är NaN anges motsvarande dimension för fönstret till standardvärdet.
|
flash.html:HTMLLoader — Ett nytt HTMLLoader-objekt som finns på scenen för det nya NativeWindow-objektet.
|
getHistoryAt | () | metod |
public function getHistoryAt(position:uint):flash.html:HTMLHistoryItem| Körningsmiljöversioner: | AIR 1.0 |
Returnerar historikposten vid den angivna positionen.
Parametrar
position:uint — Positionen i historiklistan.
|
flash.html:HTMLHistoryItem — Ett URLRequest-objekt för historikposten vid den angivna positionen.
|
Relaterade API-element
historyBack | () | metod |
public function historyBack():void| Körningsmiljöversioner: | AIR 1.0 |
Navigerar bakåt i webbläsarhistoriken, om det är möjligt.
Att anropa den här metoden för HTMLLoader-objektet har samma effekt som att anropa metoden back() för egenskapen window.history i JavaScript-kod på HTML-sidan.
Den här funktionen genererar inga felmeddelanden.
Relaterade API-element
historyForward | () | metod |
public function historyForward():void| Körningsmiljöversioner: | AIR 1.0 |
Navigerar framåt i webbläsarhistoriken, om det är möjligt.
Att anropa den här metoden för HTMLLoader-objektet har samma effekt som att anropa metoden forward() för egenskapen window.history i JavaScript-kod på HTML-sidan.
Den här funktionen genererar inga felmeddelanden.
Relaterade API-element
historyGo | () | metod |
public function historyGo(steps:int):void| Körningsmiljöversioner: | AIR 1.0 |
Navigerar angivet antal steg i webbläsarhistoriken. Navigerar framåt om värdet är positivt och bakåt om värdet är negativt. Navigering med värdet noll tvingar fram en ny inläsning.
Den här metoden motsvarar att anropa metoden go() för egenskapen window.history i JavaScript-kod på HTML-sidan.
Den här funktionen genererar inga felmeddelanden.
Parametrar
steps:int — Antal steg som ska flyttas framåt (positivt) eller bakåt (negativt) i historiklistan.
|
Relaterade API-element
load | () | metod |
public function load(urlRequestToLoad:URLRequest):void| Körningsmiljöversioner: | AIR 1.0 |
Läser in HTMLLoader-objektet med data från den plats som anges av parametern urlRequestToLoad. Om den här metoden anropas initialt anges egenskapen loaded till false. Den här metoden initierar en åtgärd som alltid slutförs asynkront.
Ett anrop till den här metoden avbryter implicit alla tidigare väntande inläsningar som har initierats med den här metoden eller metoden loadString(). complete-händelsen för den tidigare inläsningen levereras aldrig.
Det är möjligt att complete-händelsen aldrig levereras. Detta inträffar om någon del av det HTML-innehåll som läses in i HTMLLoader-objektet aldrig laddas ned helt. Det kan inträffa om HTML-innehållet refererar till en URL till ett CGI-skript som hela tiden genererar nytt innehåll.
Parametrar
urlRequestToLoad:URLRequest — Det URLRequest-objekt som innehåller information om den URL som ska läsas in. Förutom den URL som ska läsas in, innehåller ett URLRequest-objekt egenskaper som anger metoden för att skicka HTTP-formulär (GET eller POST), eventuella data som ska överföras med begäran samt begäransrubriker.
|
Relaterade API-element
loadString | () | metod |
public function loadString(htmlContent:String):void| Körningsmiljöversioner: | AIR 1.0 |
Läser in HTMLLoader-objektet med HTML-innehållet som finns i HTML-strängen. När återgivningen av HTML-innehållet i strängen har slutförts skickas complete-händelsen. complete-händelsen skickas alltid asynkront.
Ett anrop till den här metoden avbryter implicit alla tidigare väntande inläsningar som har initierats med den här metoden eller metoden load(). complete-händelsen för den tidigare inläsningen levereras aldrig.
Om HTML-innehållet som anges i strängen saknar referenser till externa resurser återger den här metoden HTML-innehållet synkront. Däremot skickas complete-händelsen fortfarande asynkront. Om egenskapen loaded för den här klassen har värdet true omedelbart efter ett anrop till den här funktionen, återgavs HTML-innehållet som hade angetts i argumentet htmlContent synkront.
Det är möjligt att complete-händelsen aldrig levereras. Detta inträffar om någon del av det HTML-innehåll som läses in i HTMLLoader-objektet aldrig laddas ned helt. Det kan inträffa om HTML-innehållet refererar till en URL till ett CGI-skript som hela tiden genererar nytt innehåll.
Innehåll som läses in via metoden loadString() placeras bara i programmets säkerhetssandlåda om egenskapen placeLoadStringContentInApplicationSandbox ställs in på true.
Parametrar
htmlContent:String — Strängen med det HTML-innehåll som ska läsas in i HTMLLoader-objektet.
|
Relaterade API-element
reload | () | metod |
public function reload():void| Körningsmiljöversioner: | AIR 1.0 |
Läser in sidan från den aktuella platsen på nytt.
complete | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.COMPLETE| Körningsmiljöversioner: | AIR 1.0 |
Signalerar att den senaste inläsningen som begärdes av loadString- eller load-metoden har slutförts. Den här händelsen skickas efter att JavaScript-händelsen load har utlösts för HTML DOM i HTMLLoader-objektet. Den här händelsen skickas alltid asynkront. Händelsehanteraren för den här händelsen kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.
Event.COMPLETE-konstanten definierar värdet på type-egenskapen i ett complete-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det nätverksobjekt som har lästs in. |
Relaterade API-element
htmlBoundsChange | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.HTML_BOUNDS_CHANGE| Körningsmiljöversioner: | AIR 1.0 |
Signalerar att den ena eller båda contentWidth och contentHeight-egenskaperna i ett TMLLoader-objekt har ändrats. Detta kan vara ett resultat av exempelvis inläsning av en ny bild eller annat innehåll. Händelsehanterare kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.
HTMLLoader-objektet kan skicka den här händelsen när som helst efter att en load-åtgärd har initierats, även efter att complete-händelsen har skickats.
Event.HTML_BOUNDS_CHANGE-konstanten definierar värdet på type-egenskapen i ett htmlBoundsChange-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | HTMLLoader-objektet. |
target | HTMLLoader-objektet. |
Relaterade API-element
htmlDOMInitialize | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.HTML_DOM_INITIALIZE| Körningsmiljöversioner: | AIR 1.0 |
Signalerar att HTML DOM har skapats som svar på en inläsning. Metoderna load() och loadString() för HTMLLoader-objektet genererar ett undantag när den här händelsen skickas. Ett undantag genereras av alla egenskaper och metoder för alla JavaScript-objekt som går att komma åt från egenskapen window för det HTMLLoader-objekt som styr vilken URL som läses in i HTMLLoader-objektet, om de anges eller anropas när den här händelsen skickas. Exempelvis genereras ett JavaScript-undantag om window.location anges genom att ställa in egenskapen window för HTMLLoader-objektet.
Event.HTML_DOM_INITIALIZE-konstanten definierar värdet på type-egenskapen i ett htmlDOMInitialize-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | HTMLLoader-objektet. |
target | HTMLLoader-objektet. |
Relaterade API-element
htmlRender | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.HTML_RENDER| Körningsmiljöversioner: | AIR 1.0 |
Signalerar att återgivningen av innehåll i HTMLLoader-objektet är helt uppdaterad. Den här händelsen kan skickas ganska ofta – varje gång en ändring i återgivningen av HTML-innehållet görs. Exempelvis skickas den här händelsen när nytt innehåll visas till följd av att en användare klickar på en länk eller när JavaScript på sidan återger HTML. Händelselyssnare kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.
Hanterare för den här händelsen ska kontrollera egenskaperna contentWidth och contentHeight för HTMLLoader för att uppdatera eventuella rullningslister som har associerats med den.
HTMLLoader-objektet kan skicka den här händelsen när som helst efter att en load-åtgärd har initierats, även efter att complete-händelsen har skickats.
Event.HTML_RENDER-konstanten definierar värdet på type-egenskapen i ett htmlRender-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | HTMLLoader-objektet. |
target | HTMLLoader-objektet. |
locationChange | Händelse |
flash.events.LocationChangeEventegenskap LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE| Körningsmiljöversioner: | AIR 2.7 |
Signalerar att egenskapen location för HTMLLoader-objektet har ändrats. Händelsehanteraren för den här händelsen kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.
En locationChange-händelse med typen LocationChangeEvent skickas av HTMLLoader i program som använder namnutrymmen för AIR 2.7 och senare. I tidigare AIR-versioner är det skickade händelseobjektet en instans av Event-klassen.
Relaterade API-element
locationChange | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.LOCATION_CHANGE| Körningsmiljöversioner: | AIR 1.0 |
Signalerar att egenskapen location för HTMLLoader-objektet har ändrats. Händelsehanteraren för den här händelsen kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.
En locationChange-händelse med typen Event skickas av HTMLLoader i program där ett namnutrymme före AIR 2.7 används. I AIR 2.7 och senare är händelseobjektet en instans av LocationChangeEvent-klassen, som ger ytterligare en location-egenskap inställd för den nya URL-sidan.
Event.LOCATION_CHANGE-konstanten definierar värdet på type-egenskapen i ett locationChange-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | HTMLLoader-objektet. |
target | HTMLLoader-objektet. |
Relaterade API-element
locationChanging | Händelse |
flash.events.LocationChangeEventegenskap LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 2.7 |
Signalerar att egenskapen location för HTMLLoader-objektet är på väg att ändras.
En locationChanging-händelse skickas endast när platsen initieras genom en användarinteraktion, som exempelvis när användaren klickar på en länk eller när kod körs i HTMLLoader, som exempelvis vid en omdirigering på klientsidan. Den nya platsen visas som standard i det här HTMLLoader-objektet. Du kan anropa metoden preventDefault() för händelseobjektet om du vill avbryta standardbeteendet. Du kan till exempel använda funktionen flash.net.navigateToURL() för att öppna sidan i systemets webbläsare baserat på egenskapen location för händelseobjektet..
En locationChanging()-händelse skickas inte när du anropar följande metoder:
- load()
- loadString()
- reload()
- historyBack()
- historyForward()
- historyGo()
Dessutom skickas inte denna händelse när egenskapen navigateInSystemBrowser är true och destinationssidan är öppen i systemets webbläsare eftersom HTMLLoader-platsen inte ändras.
LOCATION_CHANGING definierar värdet på den type-egenskap som LocationChangeEvent-objektet skickade före en sidplatsförändring.
Exempel ( Så här använder du exemplet )
package{
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class LocationChanging extends Sprite
{
var htmlLoader:HTMLLoader = new HTMLLoader();
public function LocationChanging()
{
htmlLoader.width = stage.stageWidth;
htmlLoader.height = stage.stageHeight;
htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
this.addChild( htmlLoader );
}
private function onLocationChanging( event:LocationChangeEvent ):void
{
trace( "Location changing: " + event.location );
if ( event.location.indexOf( "http://www.adobe.com" ) < 0 )
{
event.preventDefault();
}
}
}
}
scroll | Händelse |
flash.events.Eventegenskap Event.type =
flash.events.Event.SCROLL| Körningsmiljöversioner: | AIR 1.0 |
Signalerar att egenskapen scrollH eller scrollV har ändrats av HTMLLoader-objektet. HTMLLoader-objektet skickar den här händelsen när JavaScript som körs i HTMLLoader-objektet anropar metoden scrollTo() för window-objektet och den önskade platsen inte redan är synlig. Händelsen skickas inte när ActionScript-koden ändrar egenskapen scrollH eller scrollV. Händelsehanterare kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet.
Händelsehanterare för den här händelsen ska kontrollera egenskaperna scrollH och scrollV för att uppdatera eventuella rullningslister som har associerats med HTMLLoader-objektet.
HTMLLoader-objektet kan skicka den här händelsen när som helst efter att en load-åtgärd har initierats, även efter att complete-händelsen har skickats.
Event.SCROLL-konstanten definierar värdet på type-egenskapen i ett scroll-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
target | Det TextField-objekt som har rullats. target-egenskapen är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
uncaughtScriptException | Händelse |
flash.events.HTMLUncaughtScriptExceptionEventegenskap HTMLUncaughtScriptExceptionEvent.type =
flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION| Körningsmiljöversioner: | AIR 1.0 |
Signalerar att ett ohanterat JavaScript-undantag har inträffat i HTMLLoader-objektet. Händelsehanterare kan anropa alla metoder och komma åt alla egenskaper för HTMLLoader-objektet. Händelsen kan avbrytas och standardbeteendet när den körs i ADL (AIR Debug Launcher) är att skicka JavaScript-stacken till trace-utdata.
HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION-konstanten definierar värdet på type-egenskapen i ett uncaughtScriptException-händelseobjekt.
Den här händelsen har följande egenskaper:
| Egenskap | Värde |
|---|---|
bubbles | false |
cancelable | false; det finns inget standardbeteende att avbryta. |
exceptionValue | Resultatet av en utvärdering av uttrycket i throw-satsen som resulterade i det ofångade undantaget. |
stackTrace | En array med objekt som representerar stackspårningen vid den tidpunkt då throw-satsen, som resulterade i det ofångade undantaget, verkställdes. |
target | HTMLLoader-objektet. |
Relaterade API-element
package {
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class HTMLLoaderExample extends Sprite
{
public function HTMLLoaderExample()
{
var html:HTMLLoader = new HTMLLoader();
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.width = stage.stageWidth;
html.height = stage.stageHeight;
html.load(urlReq);
addChild(html);
}
}
}
Tue Jun 12 2018, 01:40 PM Z