Pacchetto | flash.media |
Classe | public final class StageWebView |
Ereditarietà | StageWebView EventDispatcher Object |
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
La classe StageWebView offre un modo semplice per visualizzare contenuto HTML su dispositivi che non supportano la classe HTMLLoader. La classe non consente alcuna interazione tra ActionScript e il contenuto HTML tranne che attraverso i metodi e le proprietà della classe StageWebView stessa. Ad esempio, non vi è modo di passare valori o chiamare funzioni tra ActionScript e JavaScript.
Supporto profili AIR: questa funzionalità è supportata in tutti i sistemi operativi desktop e i dispositivi mobili, ma non nei dispositivi AIR per TV. È possibile verificare se la funzionalità è supportata in fase runtime utilizzando la proprietà StageWebView.isSupported
. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.
Nei dispositivi dei profili mobile e mobile esteso, la classe StageWebView utilizza il controllo web di sistema fornito dal sistema operativo del dispositivo. Di conseguenza, le funzioni disponibili e l’aspetto del rendering possono variare da un dispositivo all’altro.
In Android, il video HTML5 in linea è supportato solo se si include <application android:hardwareAccelerated="true"/>
nel descrittore dell’applicazione.
Nei computer desktop (nei profili desktop e desktop esteso), la classe StageWebView utilizza il controllo Web di sistema fornito dal plug-in Flash Player. Le funzioni disponibili e l’aspetto del rendering sono uguali a quelli della classe HTMLLoader (senza la stretta integrazione e il bridging di script tra ActionScript e JavaScript consentiti da un’istanza HTMLLoader). Poiché la classe HTMLLoader utilizza il motore AIR WebKit interno, si sconsiglia l’uso simultaneo di istanze HTMLLoader e StageWebView, poiché presenta un funzionamento imprevisto e può provocare l’arresto anomalo dell’applicazione.
La classe StageWebView NON è un oggetto di visualizzazione e non può essere aggiunta all'elenco di visualizzazione di Flash. Per visualizzare un oggetto StageWebView, è invece necessario associarlo direttamente a uno stage utilizzando la proprietà stage
. L'istanza StageWebView associata a uno stage viene visualizzata sopra gli oggetti di visualizzazione di Flash, se presenti. Per controllare le dimensioni e la posizione dell'area di rendering, utilizzate la proprietà viewPort
. Non è possibile controllare l'ordine di profondità di diversi oggetti StageWebView. La sovrapposizione di due istanze è sconsigliata.
Quando il contenuto dell'oggetto StageWebView è l'elemento attivo, l'oggetto StageWebView ha la prima opportunità di gestire l'input della tastiera. Lo stage al quale è associato l'oggetto StageWebView invia l'input della tastiera che non viene gestito. Il normale ciclo di cattura/bubbling degli eventi non entra in gioco qui perché l'istanza StageWebView non fa parte dell'elenco di visualizzazione.
In Android 3.0+, un'applicazione deve abilitare l'accelerazione hardware nell'elemento Android manifestAdditions del descrittore dell'applicazione AIR per visualizzare il contenuto plug-in in un oggetto StageWebView.
Altri esempi
Altre informazioni
Elementi API correlati
Proprietà | Definito da | ||
---|---|---|---|
constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | ||
isHistoryBackEnabled : Boolean [sola lettura]
Segnala se è presente una pagina precedente nella cronologia di navigazione. | StageWebView | ||
isHistoryForwardEnabled : Boolean [sola lettura]
Segnala se è presente una pagina seguente nella cronologia di navigazione. | StageWebView | ||
isSupported : Boolean [statico] [sola lettura]
Segnala se la classe StageWebView è supportata dal dispositivo corrente. | StageWebView | ||
location : String [sola lettura]
L'URL della posizione corrente. | StageWebView | ||
mediaPlaybackRequiresUserAction : Boolean
Specificate se è necessario l'utente per eseguire il movimento per riprodurre il contenuto multimediale. | StageWebView | ||
stage : Stage
Lo stage sul quale viene visualizzato questo oggetto StageWebView. | StageWebView | ||
title : String [sola lettura]
Il valore del titolo HTML. | StageWebView | ||
viewPort : Rectangle
L'area dello stage in cui viene visualizzato questo oggetto StageWebView. | StageWebView |
Metodo | Definito da | ||
---|---|---|---|
Crea un oggetto StageWebView. | StageWebView | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | ||
Assegna lo stato di attivazione al contenuto di questo oggetto StageWebView. | StageWebView | ||
Invia un evento nel flusso di eventi. | EventDispatcher | ||
Elimina questo oggetto StageWebView. | StageWebView | ||
Disegna il riquadro di visualizzazione di StageWebView su una bitmap. | StageWebView | ||
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | ||
Indica se per un oggetto è definita una proprietà specifica. | Object | ||
Va alla pagina precedente della cronologia di navigazione. | StageWebView | ||
Va alla pagina successiva della cronologia di navigazione. | StageWebView | ||
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | ||
Carica e visualizza la stringa HTML specifiata. | StageWebView | ||
Carica la pagina all'URL specificato. | StageWebView | ||
Indica se la proprietà specificata esiste ed è enumerabile. | Object | ||
Ricarica la pagina corrente. | StageWebView | ||
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | ||
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | ||
Ferma l'operazione di caricamento in corso. | StageWebView | ||
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | ||
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | ||
Restituisce il valore di base dell'oggetto specificato. | Object | ||
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher |
Evento | Riepilogo | Definito da | ||
---|---|---|---|---|
[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo. | EventDispatcher | |||
Segnala che l'ultima operazione di caricamento richiesta dal metodo loadString() o loadURL() è stata completata. | StageWebView | |||
[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo. | EventDispatcher | |||
Segnala che si è verificato un errore. | StageWebView | |||
Inviato quando l'oggetto StageWebView riceve lo stato di attivazione. | StageWebView | |||
Inviato quando l'oggetto StageWebView rilascia lo stato di attivazione. | StageWebView | |||
Segnala che è stata modificata la proprietà location dell'oggetto StageWebView. | StageWebView | |||
Segnala che la proprietà location dell'oggetto StageWebView sta per cambiare. | StageWebView |
isHistoryBackEnabled | proprietà |
isHistoryForwardEnabled | proprietà |
isSupported | proprietà |
location | proprietà |
mediaPlaybackRequiresUserAction | proprietà |
mediaPlaybackRequiresUserAction:Boolean
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 21.0 |
Specificate se è necessario l'utente per eseguire il movimento per riprodurre il contenuto multimediale. Per iOS, questa proprietà non viene rispettata e la riproduzione automatica dei supporti può essere ottenuta solo attraverso la funzione di costruzione StageWebView ()
. Il valore predefinito è True.
Implementazione
public function get mediaPlaybackRequiresUserAction():Boolean
public function set mediaPlaybackRequiresUserAction(value:Boolean):void
stage | proprietà |
stage:Stage
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Lo stage sul quale viene visualizzato questo oggetto StageWebView.
Impostate stage
su null
per nascondere questo oggetto StageWebView.
Implementazione
public function get stage():Stage
public function set stage(value:Stage):void
title | proprietà |
viewPort | proprietà |
viewPort:Rectangle
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
L'area dello stage in cui viene visualizzato questo oggetto StageWebView.
Implementazione
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Genera
RangeError — Il valore Rectangle non è valido.
|
StageWebView | () | Funzione di costruzione |
public function StageWebView(useNative:Boolean = false, mediaPlaybackRequiresUserAction:Boolean = true)
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Crea un oggetto StageWebView.
L'oggetto è invisibile finché rimane associato a uno stage e finché viewPort
è impostato.
Nota: anche se non vietato, con alcuni contenuti si possono verificare degli errori quando lo stesso processo utilizza il WebKit integrato e quello di sistema; pertanto si consiglia di costruire tutti gli oggetti StageWebView di una data applicazione con lo stesso valore per useNative. Inoltre, dato che HTMLLoader dipende dal WebKit integrato, le applicazioni che utilizzano HTMLLoader dovrebbero costruire solo oggetti StageWebView con useNative impostato su false.
ParametriuseNative:Boolean (default = false ) — Se useNative è impostato su false, una versione di WebKit integrata in AIR viene utilizzata come origine dell’oggetto StageWebView creato. Se useNative è impostato su true, AIR utilizza il motore Web predefinito di sistema. Le piattaforme mobili supportano solo l’utilizzo del motore Web di sistema, quindi useNative viene ignorato in tali piattaforme.
| |
mediaPlaybackRequiresUserAction:Boolean (default = true ) — il valore predefinito è true. Quando mediaPlaybackRequiresUserAction è true, WebView richiede l'azione dell'utente richiede per la riproduzione. Se è false, il contenuto di WebView viene riprodotto automaticamente.
|
assignFocus | () | metodo |
public function assignFocus(direction:String = "none"):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Assegna lo stato di attivazione al contenuto di questo oggetto StageWebView.
I valori di direzione vengono definiti nella classe FocusDirection e sono: "bottom", "none" e "top".
Parametri
direction:String (default = "none ") — Specifica se il primo o ultimo oggetto attivabile nel contenuto visualizzato deve ricevere lo stato di attivazione.
|
Elementi API correlati
dispose | () | metodo |
public function dispose():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Elimina questo oggetto StageWebView.
La chiamata di dispose()
è opzionale. Se non mantenete un riferimento a questa istanza StageWebView, essa è idonea per il processo di garbage collection. La chiamata di dispose()
può anticipare il processo di garbage collection oppure farlo avvenire in un momento più opportuno.
drawViewPortToBitmapData | () | metodo |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.6 |
Disegna il riquadro di visualizzazione di StageWebView su una bitmap.
Per visualizzare il contenuto sopra l'oggetto StageWebView, acquisite la bitmap e impostate lo stage su null
.
Nota: il comportamento di questo metodo non è garantito per le pagine che includono contenuti di plugin (ad esempio file PDF e SWF incorporati).
Parametri
bitmap:BitmapData — L'oggetto BitmapData su cui disegnare la parte visibile del riquadro di visualizzazione di StageWebView.
|
Genera
ArgumentError — L'altezza e la larghezza della bitmap sono diverse rispetto a quelle del riquadro di visualizzazione.
| |
Error — La bitmap è null.
|
Esempio ( Come utilizzare questo esempio )
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 | () | metodo |
public function historyBack():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Va alla pagina precedente della cronologia di navigazione.
historyForward | () | metodo |
public function historyForward():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Va alla pagina successiva della cronologia di navigazione.
loadString | () | metodo |
public function loadString(text:String, mimeType:String = "text/html"):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Carica e visualizza la stringa HTML specifiata.
Quando si usa il metodo loadString()
, il valore location
riportato è "about:blank". Solo gli schemi URI standard possono essere utilizzati negli URL con la stringa HTML. Gli schemi URI AIR "app:" e "app-storage:" non sono consentiti.
Il contenuto HTML non può caricare risorse locali, ad esempio file di immagine. Le richieste XMLHttpRequest non sono consentite.
Solo i tipi MIME "text/html" e "application/xhtml+xml" sono supportati.
Parametri
text:String — La stringa di contenuto HTML o XHTML da visualizzare.
| |
mimeType:String (default = "text/html ") — Il tipo MIME del contenuto: "text/html" o "application/xhtml+xml".
|
Esempio ( Come utilizzare questo esempio )
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 | () | metodo |
public function loadURL(url:String):void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Carica la pagina all'URL specificato.
L'URL può utilizzare i seguenti schemi URI: http:, https:, file:, data: e javascript:. Il contenuto caricato con lo schema file: può caricare altre risorse locali.
Parametri
url:String |
Esempio ( Come utilizzare questo esempio )
loadURL()
.
Nota: in Android, è necessario specificare l'autorizzazione INTERNET nel descrittore dell'applicazione AIR per caricare gli URL remoti.
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 | () | metodo |
public function reload():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Ricarica la pagina corrente.
stop | () | metodo |
public function stop():void
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Ferma l'operazione di caricamento in corso.
complete | Evento |
flash.events.Event
proprietà Event.type =
flash.events.Event.COMPLETE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Segnala che l'ultima operazione di caricamento richiesta dal metodo loadString()
o loadURL()
è stata completata.
Event.COMPLETE
definisce il valore della proprietà type
di un oggetto evento complete
.
Questo evento ha le seguenti proprietà:
Proprietà | Valore |
---|---|
bubbles | false |
cancelable | false ; non è presente alcun comportamento predefinito da annullare. |
currentTarget | L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. |
target | L'oggetto di rete che ha completato il caricamento. |
error | Evento |
flash.events.ErrorEvent
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Segnala che si è verificato un errore.
focusIn | Evento |
flash.events.FocusEvent
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Inviato quando l'oggetto StageWebView riceve lo stato di attivazione.
focusOut | Evento |
flash.events.FocusEvent
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Inviato quando l'oggetto StageWebView rilascia lo stato di attivazione.
locationChange | Evento |
flash.events.LocationChangeEvent
proprietà LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Segnala che è stata modificata la proprietà location
dell'oggetto StageWebView.
L'evento non può essere annullato.
Inviato dopo ogni cambiamento di posizione. locationChanging | Evento |
flash.events.LocationChangeEvent
proprietà LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING
Versione linguaggio: | ActionScript 3.0 |
Versioni runtime: | AIR 2.5 |
Segnala che la proprietà location
dell'oggetto StageWebView sta per cambiare.
Un evento locationChanging viene inviato solo quando il cambiamento di posizione viene avviato tramite il contenuto HTML o tramite un codice in esecuzione nell'oggetto StageWebView, ad esempio quando un utente fa clic su un collegamento. Per impostazione predefinita, la nuova posizione viene visualizzata in questo oggetto StageWebView. Potete chiamare il metodo preventDefault()
dell'oggetto evento per annullare il comportamento predefinito. Ad esempio, potreste usare la funzione flash.net.navigateToURL()
per aprire la pagina nel browser di sistema in base alla proprietà location
dell'oggetto evento
Un evento locationChanging non viene inviato quando si cambia la posizione con i seguenti metodi:
historyBack()
historyForward()
loadString()
loadURL()
reload()
LOCATION_CHANGING
definisce il valore della proprietà type
dell'oggetto LocationChangeEvent inviato prima del cambiamento di posizione della pagina.
loadURL()
e utilizza i tasti virtuali Indietro e Cerca del dispositivo per la navigazione nella cronologia.
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, 02:44 PM Z