Paket | flash.media |
Klass | public final class StageWebView |
Arv | StageWebView EventDispatcher Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Klassen StageWebView är ett enkelt sätt att visa HTML-innehåll på enheter där klassen HTMLLoader inte stöds. Klassen tillhandahåller ingen samverkan mellan ActionScript och HTML-innehållet, med undantag för metoderna och egenskaperna i själva StageWebView-klassen. Det går till exempel inte att skicka värden eller anropa funktioner mellan ActionScript och JavaScript.
Stöd för AIR-profiler: Den här funktionen stöds på alla operativsystem för datorer och på mobilenheter, men inte på enheter med AIR for TV. Du kan testa stödet vid körning med egenskapen StageWebView.isSupported
. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
På enheter i mobilprofilerna och de utökade mobilprofilerna använder klassen StageWebView de systemwebbkontroller som finns i enhetens operativsystem. De tillgängliga funktionerna och återgivningsutseendet kan därför variera från enhet till enhet.
På Android stöds infogad HTML5-video bara om <application android:hardwareAccelerated="true"/>
inkluderas i programbeskrivningen.
På skrivbordsdatorer (med skrivbordsprofilen och den utökade skrivbordsprofilen) använder klassen StageWebView den systemwebbkontroll som finns i plugin-programmet Flash Player. De tillgängliga funktionerna och återgivningsutseendet är samma som för klassen HTMLLoader (men utan den integration och skriptbryggning mellan ActionScript och JavaScript som en HTMLLoader-instans ger). Eftersom klassen HTMLLoader använder den interna AIR WebKit-motorn bör du inte använda StageWebView- och HTMLLoader-instanser samtidigt, då detta har odefinierade beteenden och eventuellt kan avsluta programmet.
Klassen StageWebView är INTE ett visningsobjekt och kan inte läggas till i visningslistan i Flash. Du visar ett StageWebView-objekt genom att koppla det direkt till en scen med egenskapen stage
. En StageWebView-instans som kopplats till en scen visas ovanpå alla andra Flash-visningsobjekt. Du anger storleken och positionen för återgivningsområdet med egenskapen viewPort
. Det går inte att styra ordningen på djupet för olika StageWebView-objekt. Du bör inte överlappa två instanser.
När innehållet i StageWebView-objektet har fokus har StageWebView-objektet tillfälle att hantera indata från tangentbordet först. Den scen som StageWebView-objektet är kopplat till skickar eventuella tangentbordsindata som inte hanteras. Den normala cykeln med hämtnings- och bubblingsfaser för händelser gäller inte här, eftersom StageWebView-instansen inte ingår i visningslistan.
I Android 3.0+ måste ett program aktivera maskinvaruacceleration i Android-elementet manifestAdditions för AIR-programbeskrivningsfilen för att plugin-innehåll i ett StageWebView-objekt ska visas.
Lär dig mer
Relaterade API-element
Egenskap | Definieras med | ||
---|---|---|---|
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
isHistoryBackEnabled : Boolean [skrivskyddad]
Rapporterar om det finns en tidigare sida i webbläsarhistoriken. | StageWebView | ||
isHistoryForwardEnabled : Boolean [skrivskyddad]
Rapporterar om det finns en nästa sida i webbläsarhistoriken. | StageWebView | ||
isSupported : Boolean [statisk] [skrivskyddad]
Rapporterar om klassen StageWebView stöds på den aktuella enheten. | StageWebView | ||
location : String [skrivskyddad]
URL för den aktuella platsen. | StageWebView | ||
mediaPlaybackRequiresUserAction : Boolean
Ange om användaren måste utföra en gest för att spela upp medieinnehållet. | StageWebView | ||
stage : Stage
Den scen som det här StageWebView-objektet visas på. | StageWebView | ||
title : String [skrivskyddad]
Värdet för HTML-titeln. | StageWebView | ||
viewPort : Rectangle
Den del på scenen där StageWebView-objektet visas. | StageWebView |
Metod | Definieras med | ||
---|---|---|---|
Skapar ett StageWebView-objekt. | StageWebView | ||
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 | ||
Tilldelar fokus till innehållet i det här StageWebView-objektet. | StageWebView | ||
Skickar en händelse till händelseflödet. | EventDispatcher | ||
Släpper det här StageWebView-objektet. | StageWebView | ||
Ritar visningsporten för StageWebView i en bitmapp. | StageWebView | ||
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 till föregående sida i webbläsarhistoriken. | StageWebView | ||
Navigerar till nästa sida i webbläsarhistoriken. | StageWebView | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Läser in och visar den angivna HTML-strängen. | StageWebView | ||
Läser in sidan på den angivna URL:en. | StageWebView | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Läser in den aktuella sidan igen. | StageWebView | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Stoppar den aktuella inläsningen. | StageWebView | ||
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 | |||
Signalerar att den senaste inläsningen som begärdes av loadString()- eller loadURL()-metoden har slutförts. | StageWebView | |||
[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | |||
Signalerar att ett fel har inträffat. | StageWebView | |||
Skickas när det här StageWebView-objektet får fokus. | StageWebView | |||
Skickas när StageWebView släpper fokus. | StageWebView | |||
Signalerar att egenskapen location för StageWebView-objektet har ändrats. | StageWebView | |||
Signalerar att egenskapen location för StageWebView-objektet är på väg att ändras. | StageWebView |
isHistoryBackEnabled | egenskap |
isHistoryForwardEnabled | egenskap |
isSupported | egenskap |
location | egenskap |
mediaPlaybackRequiresUserAction | egenskap |
mediaPlaybackRequiresUserAction:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 21.0 |
Ange om användaren måste utföra en gest för att spela upp medieinnehållet. I iOS respekteras inte den här egenskapen och automatisk uppspelning av media kan bara uppnås via konstruktorn StageWebView()
. Standardvärdet är true.
Implementering
public function get mediaPlaybackRequiresUserAction():Boolean
public function set mediaPlaybackRequiresUserAction(value:Boolean):void
stage | egenskap |
title | egenskap |
viewPort | egenskap |
viewPort:Rectangle
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Den del på scenen där StageWebView-objektet visas.
Implementering
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Utlöser
RangeError — Rectangle-värdet är inte giltigt.
|
StageWebView | () | Konstruktor |
public function StageWebView(useNative:Boolean = false, mediaPlaybackRequiresUserAction:Boolean = true)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Skapar ett StageWebView-objekt.
Objektet är osynligt tills det kopplats till en scen och tills viewPort
anges.
Obs! En process kan använda både inbäddad WebKit och systemets WebKit, men med en del innehåll orsakar detta fel. Därför bör alla StageWebViews i ett och samma program konstrueras med samma värde för useNative. Dessutom är HTMLLoader beroende av den inbäddade WebKit-versionen, och därför bör program som använder HTMLLoader bara konstruera StageWebViews med useNative inställt på falskt.
ParametraruseNative:Boolean (default = false ) — När useNative är falskt används en WebKit-version som är inbäddad i AIR som källa för den StageWebView som skapas. När useNative är sant används systemets standardwebbmotor i AIR. Mobila plattformar har bara stöd för att använda systemets webbmotor, därför ignoreras useNative på mobilplattformar.
| |
mediaPlaybackRequiresUserAction:Boolean (default = true ) — anges som standard till true. När mediaPlaybackRequiresUserAction är true, måste användaren utföra en åtgärd för att spela upp WebView. Om värdet är false, kommer WebView-innehåll att spelas upp automatiskt.
|
assignFocus | () | metod |
public function assignFocus(direction:String = "none"):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Tilldelar fokus till innehållet i det här StageWebView-objektet.
Riktningsvärden definieras i klassen FocusDirection och inkluderar "bottom", "none" och "top".
Parametrar
direction:String (default = "none ") — Anger om det första eller sista objekt, som kan tilldelas fokus i det visade innehållet, ska få fokus.
|
Relaterade API-element
dispose | () | metod |
public function dispose():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Släpper det här StageWebView-objektet.
Anrop av dispose()
är valfritt. Om du inte bibehåller någon referens till den här StageWebView-instansen blir den tillgänglig för skräpinsamling. Om du anropar dispose()
kan skräpinsamlingen ske tidigare eller vid en mer lämplig tidpunkt.
drawViewPortToBitmapData | () | metod |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.6 |
Ritar visningsporten för StageWebView i en bitmapp.
Hämta bitmappen och ange scenen till null
för visning av innehållet ovanför StageWebView-objektet.
Obs! Beteendet för denna metod garanteras inte för sidor som innehåller plugin-innehåll (till exempel inbäddade PDF- och SWF-filer).
Parametrar
bitmap:BitmapData — Objektet BitmapData där den synliga delen av visningsporten för StageWebView ska ritas.
|
Utlöser
ArgumentError — Bitmappens bredd eller höjd skiljer sig från visningsportens bredd eller höjd.
| |
Error — Bitmappen är null.
|
Exempel ( Så här använder du exemplet )
package { import flash.display.Bitmap; import flash.display.BitmapData; import flash.display.Sprite; import flash.events.*; import flash.geom.Rectangle; import flash.media.StageWebView; import flash.net.*; import flash.text.TextField; public class stagewebview1 extends Sprite { public var webView:StageWebView = new StageWebView(); public var textGoogle:TextField=new TextField(); public var textFacebook:TextField=new TextField(); public function stagewebview() { textGoogle.htmlText="<b>Google</b>"; textGoogle.x=300; textGoogle.y=-80; addChild(textGoogle); textFacebook.htmlText="<b>Facebook</b>"; textFacebook.x=0; textFacebook.y=-80; addChild(textFacebook); textGoogle.addEventListener(MouseEvent.CLICK,goGoogle); textFacebook.addEventListener(MouseEvent.CLICK,goFaceBook); webView.stage = this.stage; webView.viewPort = new Rectangle(0, 0, stage.stageWidth, stage.stageHeight); } public function goGoogle(e:Event):void { webView.loadURL("http://www.google.com"); webView.stage = null; webView.addEventListener(Event.COMPLETE,handleLoad); } public function goFaceBook(e:Event):void { webView.loadURL("http://www.facebook.com"); webView.stage = null; webView.addEventListener(Event.COMPLETE,handleLoad); } public function handleLoad(e:Event):void { var bitmapData:BitmapData = new BitmapData(webView.viewPort.width, webView.viewPort.height); webView.drawViewPortToBitmapData(bitmapData); var webViewBitmap:Bitmap=new Bitmap(bitmapData); addChild(webViewBitmap); } } }
historyBack | () | metod |
public function historyBack():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Navigerar till föregående sida i webbläsarhistoriken.
historyForward | () | metod |
public function historyForward():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Navigerar till nästa sida i webbläsarhistoriken.
loadString | () | metod |
public function loadString(text:String, mimeType:String = "text/html"):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Läser in och visar den angivna HTML-strängen.
När metoden loadString()
används rapporteras location
som "about:blank." Du kan bara använda URI-standardscheman i URL:er i HTML-strängen. URI-schemana "app:" och "app-storage:" i AIR kan inte användas.
HTML-innehållet kan inte läsa in lokala resurser, som bildfiler. XMLHttpRequests tillåts inte.
Endast MIME-typerna "text/html" och "application/xhtml+xml" stöds.
Parametrar
text:String — Den sträng med HTML- eller XHTML-innehåll som ska visas.
| |
mimeType:String (default = "text/html ") — Innehållets MIME-typ, antingen "text/html" eller "application/xhtml+xml".
|
Exempel ( Så här använder du exemplet )
loadString()
.
var webView:StageWebView = new StageWebView(); webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); var htmlString:String = "<!DOCTYPE HTML>" + "<html>" + "<body>" + "<h1>Example</h1>" + "<p>King Phillip cut open five green snakes.</p>" + "</body>" + "</html>"; webView.loadString( htmlString, "text/html" );
loadURL | () | metod |
public function loadURL(url:String):void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Läser in sidan på den angivna URL:en.
URL:en kan använda följande URI-scheman: http:, https:, file:, data: och javascript:. Innehåll som laddas med schemat file: kan läsa in andra lokala resurser.
Parametrar
url:String |
Exempel ( Så här använder du exemplet )
loadURL()
.
Obs! På Android måste du ange INTERNET-behörighet i programbeskrivningsfilen för AIR för att läsa in fjärr-URL:er.
var webView:StageWebView = new StageWebView(); webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); webView.loadURL( "http://www.example.com" );
reload | () | metod |
public function reload():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Läser in den aktuella sidan igen.
stop | () | metod |
public function stop():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Stoppar den aktuella inläsningen.
complete | Händelse |
flash.events.Event
egenskap Event.type =
flash.events.Event.COMPLETE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Signalerar att den senaste inläsningen som begärdes av loadString()
- eller loadURL()
-metoden har slutförts.
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. |
error | Händelse |
flash.events.ErrorEvent
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Signalerar att ett fel har inträffat.
focusIn | Händelse |
flash.events.FocusEvent
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Skickas när det här StageWebView-objektet får fokus.
focusOut | Händelse |
flash.events.FocusEvent
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Skickas när StageWebView släpper fokus.
locationChange | Händelse |
flash.events.LocationChangeEvent
egenskap LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Signalerar att egenskapen location
för StageWebView-objektet har ändrats.
Det går inte att avbryta händelsen.
Skickas efter varje platsförändring. locationChanging | Händelse |
flash.events.LocationChangeEvent
egenskap LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 2.5 |
Signalerar att egenskapen location
för StageWebView-objektet är på väg att ändras.
En locationChanging-händelse skickas bara när platsändringen initieras via HTML-innehåll eller kod som körs inuti StageWebView-objektet, till exempel när användaren klickar på en länk. Den nya platsen visas som standard i det här StageWebView-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.
Det skickas ingen locationChanging-händelse när du ändrar plats för följande metoder:
historyBack()
historyForward()
loadString()
loadURL()
reload()
LOCATION_CHANGING
definierar värdet på den type
-egenskap som LocationChangeEvent-objektet skickade före en sidplatsförändring.
loadURL()
och enhetens valknappar för bakåt och sök används för att navigera bakåt i historiken.
package { import flash.display.MovieClip; import flash.media.StageWebView; import flash.geom.Rectangle; import flash.events.KeyboardEvent; import flash.ui.Keyboard; import flash.desktop.NativeApplication; public class StageWebViewExample extends MovieClip{ private var webView:StageWebView = new StageWebView(); public function StageWebViewExample() { webView.stage = this.stage; webView.viewPort = new Rectangle( 0, 0, stage.stageWidth, stage.stageHeight ); webView.loadURL( "http://www.example.com" ); stage.addEventListener( KeyboardEvent.KEY_DOWN, onKey ); } private function onKey( event:KeyboardEvent ):void { if( event.keyCode == Keyboard.BACK && webView.isHistoryBackEnabled ) { trace("Back."); webView.historyBack(); event.preventDefault(); } if( event.keyCode == Keyboard.SEARCH && webView.isHistoryForwardEnabled ) { trace("Forward."); webView.historyForward(); } } } }
Tue Jun 12 2018, 01:40 PM Z