Paket | flash.media |
Klasse | public final class StageWebView |
Vererbung | StageWebView EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Die StageWebView-Klasse stellt eine einfache Möglichkeit bereit, HTML-Inhalte auf Geräten anzuzeigen, auf denen die HTMLLoader-Klasse nicht unterstützt wird. Die Klasse ermöglicht keine Interaktion zwischen ActionScript und dem HTML-Inhalt außer durch die Methoden und Eigenschaften der StageWebView-Klasse selbst. Es gibt zum Beispiel keine Möglichkeit, Werte oder Aufruffunktionen zwischen ActionScript und JavaScript zu übergeben.
Unterstützung von AIR-Profilen: Diese Funktion wird auf allen Desktopbetriebssystemen und mobilen Geräten unterstützt, jedoch nicht auf Geräten mit AIR für TV. Mit der StageWebView.isSupported
-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum API-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Bei Geräten in den mobilen und erweiterten mobilen Profilen verwendet die StageWebView-Klasse die Systemwebkontrolle, die vom Betriebssystem des Geräts bereitgestellt wird. Deshalb können sich die verfügbaren Funktionen und Darstellungen von Gerät zu Gerät unterscheiden.
Auf Android wird HTML5-Inline-Video nur unterstützt, wenn <application android:hardwareAccelerated="true"/>
Anwendungsdeskriptor enthalten ist.
Auf Desktop-Computern (Desktop- und erweiterte Desktop-Profile) verwendet die StageWebView-Klasse die von Flash Player bereitgestellte Systemwebkontrolle. Die verfügbaren Funktionen und Darstellungen sind die gleichen wie bei der HTMLLoader-Klasse (ohne die enge Integration und Skriptbrücke zwischen ActionScript und JavaScript, die eine HTMLLoader-Instanz bereitstellt). Da die HTMLLoader-Klasse die interne AIR WebKit-Engine verwendet, wird von der gleichzeitigen Verwendung der Instanzen StageWebView und HTMLLoader stark abgeraten, da dies für undefiniertes Verhalten sorgt und die Anwendung möglicherweise beenden kann.
Die StageWebView-Klasse ist KEIN Anzeigeobjekt und kann der Flash-Anzeigeliste nicht hinzugefügt werden. Stattdessen zeigen Sie ein StageWebView-Objekt an, indem Sie es mithilfe der stage
-Eigenschaft direkt an die Bühne anhängen. Die an die Bühne angehängte StageWebView-Instanz wird über allen ggf. vorhandenen Flash-Anzeigeobjekten angezeigt. Sie steuern die Größe und Position des Renderingbereichs mit der viewPort
-Eigenschaft. Es gibt keine Möglichkeit, die Tiefenreihenfolge verschiedener StageWebView-Objekte zu steuern. Das Überlappen von zwei Instanzen wird nicht empfohlen.
Wenn der Inhalt im StageWebView-Objekt den Fokus hat, hat das StageWebView-Objekt die erste Gelegenheit zur Verarbeitung von Tastatureingaben. Die Bühne, an die das StageWebView-Objekt angehängt ist, setzt Tastatureingaben ab, die nicht verarbeitet wurden. Der normale Erfassen/Bubbling-Ablauf gilt hier nicht, da die StageWebView-Instanz kein Teil der Anzeigeliste ist.
In Android 3.0+ muss eine Anwendung die Hardwarebeschleunigung im Android-Element „manifestAdditions“ des AIR-Anwendungsdeskriptors aktivieren, damit Plug-In-Inhalte in einem StageWebView-Objekt angezeigt werden.
Weitere Informationen
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
isHistoryBackEnabled : Boolean [schreibgeschützt]
Gibt an, ob es im Browserverlauf eine vorherige Seite gibt. | StageWebView | ||
isHistoryForwardEnabled : Boolean [schreibgeschützt]
Gibt an, ob es im Browserverlauf eine nächste Seite gibt. | StageWebView | ||
isSupported : Boolean [statisch] [schreibgeschützt]
Gibt an, ob die StageWebView-Klasse auf dem aktuellen Gerät unterstützt wird. | StageWebView | ||
location : String [schreibgeschützt]
Die URL der aktuellen Position. | StageWebView | ||
mediaPlaybackRequiresUserAction : Boolean
Legt fest, ob der Benutzer Gesten durchführen muss, um Inhalte abzuspielen. | StageWebView | ||
stage : Stage
Die Bühne, auf der dieses StageWebView-Objekt angezeigt wird. | StageWebView | ||
title : String [schreibgeschützt]
Der HTML-Titelwert. | StageWebView | ||
viewPort : Rectangle
Der Bereich auf der Bühne, in dem das StageWebView-Objekt angezeigt wird. | StageWebView |
Methode | Definiert von | ||
---|---|---|---|
Erstellt ein StageWebView-Objekt. | StageWebView | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
Weist dem Inhalt in diesem StageWebView-Objekt den Fokus zu. | StageWebView | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
Entfernt dieses StageWebView-Objekt. | StageWebView | ||
Zeichnet den Viewport der StageWebView in eine Bitmap. | StageWebView | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
Navigiert zur vorherigen Seite im Browserverlauf. | StageWebView | ||
Navigiert zur nächsten Seite im Browserverlauf. | StageWebView | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
Lädt den angegebenen HTML-String und zeigt ihn an. | StageWebView | ||
Lädt die Seite unter der angegebenen URL. | StageWebView | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Lädt die aktuelle Seite neu. | StageWebView | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
Hält den aktuellen Ladevorgang an. | StageWebView | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
Ereignis | Übersicht | Definiert von | ||
---|---|---|---|---|
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | |||
Gibt an, dass der letzte Ladevorgang, der von der loadString()- oder loadURL()-Methode angefordert wurde, abgeschlossen ist. | StageWebView | |||
[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | |||
Gibt an, dass ein Fehler aufgetreten ist. | StageWebView | |||
Wird abgesetzt, wenn dieses StageWebView-Objekt den Fokus erhält. | StageWebView | |||
Wird abgesetzt, wenn StageWebView den Fokus abgibt. | StageWebView | |||
Gibt an, dass die location-Eigenschaft des StageWebView-Objekts geändert wurde. | StageWebView | |||
Gibt an, dass die location-Eigenschaft des StageWebView-Objekts gleich geändert wird. | StageWebView |
isHistoryBackEnabled | Eigenschaft |
isHistoryForwardEnabled | Eigenschaft |
isSupported | Eigenschaft |
location | Eigenschaft |
mediaPlaybackRequiresUserAction | Eigenschaft |
mediaPlaybackRequiresUserAction:Boolean
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 21.0 |
Legt fest, ob der Benutzer Gesten durchführen muss, um Inhalte abzuspielen. Unter iOS wird diese Eigenschaft nicht berücksichtigt und das autoPlay von Medien ist nur über den Konstruktor StageWebView()
möglich. Standardwert ist „True“
Implementierung
public function get mediaPlaybackRequiresUserAction():Boolean
public function set mediaPlaybackRequiresUserAction(value:Boolean):void
stage | Eigenschaft |
stage:Stage
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Die Bühne, auf der dieses StageWebView-Objekt angezeigt wird.
Stellen Sie stage
auf null
ein, um dieses StageWebView-Objekt auszublenden.
Implementierung
public function get stage():Stage
public function set stage(value:Stage):void
title | Eigenschaft |
viewPort | Eigenschaft |
viewPort:Rectangle
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Der Bereich auf der Bühne, in dem das StageWebView-Objekt angezeigt wird.
Implementierung
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Auslöser
RangeError — Der Rectangle-Wert ist nicht gültig.
|
StageWebView | () | Konstruktor |
public function StageWebView(useNative:Boolean = false, mediaPlaybackRequiresUserAction:Boolean = true)
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Erstellt ein StageWebView-Objekt.
Das Objekt ist unsichtbar, bis es an eine Bühne angehängt wird und der viewPort
festgelegt wurde.
Hinweis: Obwohl es nicht untersagt ist, können bei einigen Inhalten Fehler auftreten, wenn derselbe Vorgang das integrierte und das System-WebKit verwendet, daher wird empfohlen, dass alle StageWebViews in einer bestimmten Anwendung mit demselben Wert für useNative erstellt werden. Da HTMLLoader von dem integrierten WebKit abhängig ist, sollten darüber hinaus Anwendungen, die HTMLLoader verwenden, nur StageWebViews erstellen, bei denen useNative, auf „false“ eingestellt ist.
ParameteruseNative:Boolean (default = false ) — Wenn useNative „false“ ist, wird eine Version von WebKit, die in AIR integriert ist, als Quelle des erstellten StageWebView verwendet. Wenn useNative „true“ ist, verwendet AIR die Standardwebengine des Systems. Mobile Plattformen unterstützen nur die Systemwebengine, daher wird useNative auf mobilen Plattformen ignoriert.
| |
mediaPlaybackRequiresUserAction:Boolean (default = true ) — standardmäßig ist „true“ festgelegt. Wenn mediaPlaybackRequiresUserAction auf „true“ gesetzt ist, erfordert WebView zum Abspielen eine Benutzeraktion. Wenn dieser Wert „false“ lautet, wird der WebView-Inhalt automatisch wiedergegeben.
|
assignFocus | () | Methode |
public function assignFocus(direction:String = "none"):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Weist dem Inhalt in diesem StageWebView-Objekt den Fokus zu.
Richtungswerte sind in der FocusDirection-Klasse definiert: "bottom" (unten), "none" (keine) und "top" (oben).
Parameter
direction:String (default = "none ") — gibt an, ob das erste oder das letzte Objekt des angezeigten Inhalts, das den Fokus erhalten kann, den Fokus erhält.
|
Verwandte API-Elemente
dispose | () | Methode |
public function dispose():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Entfernt dieses StageWebView-Objekt.
Der Aufruf von dispose()
ist optional. Wenn Sie keinen Verweis auf diese StageWebView-Instanz behalten, wird sie bei der automatischen Speicherbereinigung entfernt. Mit dem Aufruf von dispose()
kann die Speicherbereinigung eher erfolgen oder zu einer passenderen Zeit.
drawViewPortToBitmapData | () | Methode |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.6 |
Zeichnet den Viewport der StageWebView in eine Bitmap.
Erfassen Sie die Bitmap und setzen Sie die Bühne auf null
, um den Inhalt über dem StageWebView-Objekt anzuzeigen.
Hinweis: Das Verhalten dieser Methode wird für Seiten, die Plug-In-Inhalte (zum Beispiel eingebettete PDF- und SWF-Dateien) enthalten, nicht garantiert.
Parameter
bitmap:BitmapData — Das BitmapData-Objekt, in dem der sichtbare Teil des StageWebView-Viewport gezeichnet werden soll.
|
Auslöser
ArgumentError — Die Breite oder Höhe der Bitmap unterscheidet sich von der Breite oder Höhe des Viewports.
| |
Error — Die Bitmap hat den Wert null.
|
Beispiel ( Verwendung dieses Beispiels )
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 | () | Methode |
public function historyBack():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Navigiert zur vorherigen Seite im Browserverlauf.
historyForward | () | Methode |
public function historyForward():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Navigiert zur nächsten Seite im Browserverlauf.
loadString | () | Methode |
public function loadString(text:String, mimeType:String = "text/html"):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Lädt den angegebenen HTML-String und zeigt ihn an.
Wenn die loadString()
-Methode verwendet wird, wird location
als „about:blank“ gemeldet. In URLs innerhalb des HTML-Strings kann nur das Standard-URI-Schema verwendet werden. Die AIR-URI-Schemas, „app:“ und „app-storage:“ sind nicht zulässig.
Der HTML-Inhalt kann keine lokalen Ressourcen wie zum Beispiel Bilddateien laden. XMLHttpRequests sind nicht zulässig.
Es werden nur die MIME-Typen „text/html“ und „application/xhtml+xml“ unterstützt.
Parameter
text:String — der String mit HTML- oder XHTML-Inhalt, der angezeigt werden soll.
| |
mimeType:String (default = "text/html ") — Der MIME-Typ des Inhalts, entweder „text/html“ oder „application/xhtml+xml“.
|
Beispiel ( Verwendung dieses Beispiels )
loadString()
-Methode.
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 | () | Methode |
public function loadURL(url:String):void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Lädt die Seite unter der angegebenen URL.
Die URL kann die folgenden URI-Schemas verwenden: http:, https:, file:, data: und javascript:. Inhalt, der mit dem file:-Schema geladen wurde, kann andere lokale Ressourcen laden.
Parameter
url:String |
Beispiel ( Verwendung dieses Beispiels )
loadURL()
-Methode.
Hinweis: Bei Android müssen Sie die INTERNET-Berechtigung im AIR-Anwendungsdeskriptor spezifizieren, um remote URLs zu laden.
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 | () | Methode |
public function reload():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Lädt die aktuelle Seite neu.
stop | () | Methode |
public function stop():void
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Hält den aktuellen Ladevorgang an.
complete | Ereignis |
flash.events.Event
Eigenschaft Event.type =
flash.events.Event.COMPLETE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Gibt an, dass der letzte Ladevorgang, der von der loadString()
- oder loadURL()
-Methode angefordert wurde, abgeschlossen ist.
Event.COMPLETE
-Konstante definiert den Wert der type
-Eigenschaft eines complete
-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
Eigenschaft | Wert |
---|---|
bubbles | false |
cancelable | false . Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, dessen Ladevorgang beendet ist. |
error | Ereignis |
flash.events.ErrorEvent
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Gibt an, dass ein Fehler aufgetreten ist.
focusIn | Ereignis |
flash.events.FocusEvent
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Wird abgesetzt, wenn dieses StageWebView-Objekt den Fokus erhält.
focusOut | Ereignis |
flash.events.FocusEvent
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Wird abgesetzt, wenn StageWebView den Fokus abgibt.
locationChange | Ereignis |
flash.events.LocationChangeEvent
Eigenschaft LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Gibt an, dass die location
-Eigenschaft des StageWebView-Objekts geändert wurde.
Das Ereignis kann nicht abgebrochen werden.
Wird nach jeder Positionsänderung abgesetzt. locationChanging | Ereignis |
flash.events.LocationChangeEvent
Eigenschaft LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING
Sprachversion: | ActionScript 3.0 |
Laufzeitversionen: | AIR 2.5 |
Gibt an, dass die location
-Eigenschaft des StageWebView-Objekts gleich geändert wird.
Ein locationChanging-Ereignis wird nur dann abgesetzt, wenn die Positionsänderung durch HTML-Inhalt oder durch Code innerhalb des StageWebView-Objekts initiiert wurde, zum Beispiel, wenn der Benutzer auf einen Hyperlink klickt. Standardmäßig wird die neue Position in diesem StageWebView-Objekt angezeigt. Sie können die preventDefault()
-Methode des Ereignisobjekts aufrufen, um das Standardverhalten zu verhindern. Sie könnten zum Beispiel die flash.net.navigateToURL()
-Funktion verwenden, um die Seite im Systembrowser basierend auf der location
-Eigenschaft des Ereignisobjekts zu öffnen.
Es wird kein locationChanging-Ereignis abgesetzt, wenn Sie die Position mit einer der folgenden Methoden ändern:
historyBack()
historyForward()
loadString()
loadURL()
reload()
LOCATION_CHANGING
-Konstante definiert den Wert der type
-Eigenschaft des LocationChangeEvent-Objekts, das vor einer Änderung der Seitenposition abgesetzt wird.
loadURL()
-Methode und verwendet die Zurück- und Suchen Softwaretaste des Geräts für die Navigation im Verlauf.
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, 10:04 AM Z