| 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):voidUtlö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.Eventegenskap 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.LocationChangeEventegenskap 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.LocationChangeEventegenskap 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
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper