Paket | flash.media |
Sınıf | public final class StageWebView |
Miras Alma | StageWebView EventDispatcher Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
StageWebView sınıfı, HTMLLoader sınıfının desteklenmediği aygıtlarda HTML içeriği görüntülemek için basit bir yöntem sağlar. Sınıf, ActionScript ve HTML içeriği arasında, StageWebView sınıfının kendi yöntemleri ve özellikleriyle gerçekleşen etkileşimler dışında hiçbir etkileşim sağlamaz. Örneğin, ActionScript ve JavaScript arasında değer iletmenin veya işlev çağırmanın herhangi bir yolu yoktur.
AIR profili desteği: Bu özellik tüm masaüstü işletim sistemlerinde ve mobil aygıtlarda desteklenir ancak AIR for TV aygıtlarında desteklenmez. Desteği çalışma zamanında StageWebView.isSupported
özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
Mobil ve genişletilmiş mobil profillerdeki aygıtlarda, StageWebView sınıfı aygıtın işletim sistemi tarafından sağlanan sistem web denetimini kullanır. Bu yüzden, kullanılabilir özellikler ve görüntü oluşturma görünümü aygıttan aygıta değişebilir.
Android'de satır içi HTML5 videosu yalnızca <application android:hardwareAccelerated="true"/>
öğesi uygulama tanımlayıcısına dahil edilirse desteklenir.
Masaüstü bilgisayarlarda (masaüstü ve genişletilmiş masaüstü profillerinde), StageWebView sınıfı Flash Player eklentisi tarafından sağlanan sistem web denetimini kullanır. Kullanılabilir özellikler ve görüntü oluşturma görünümü, HTMLLoader sınıfınınkilerle aynıdır (HTMLLoader örneği tarafından sağlanan ActionScript ve JavaScript arasında yakın tümleştirme ve komut dosyası köprüleme olmadan). HTMLLoader sınıfı, dahili AIR WebKit motorunu kullandığından, StageWebView ve HTMLLoader örneklerinin eş zamanlı kullanımı sınıf, tanımlanmayan davranış içerdiği ve uygulamayı sonlandırabileceği için kesinlikle önerilmez.
StageWebView sınıfı, bir görüntüleme nesnesi DEĞİLDİR ve Flash görüntüleme listesine eklenemez. Bunun yerine, stage
özelliğini kullanıp doğrudan sahne alanına ekleyerek bir StageWebView nesnesini görüntülersiniz. Bir sahne alanına eklenen StageWebView örneği, Flash görüntüleme nesnelerinin üzerinde görüntülenir. viewPort
özelliğiyle görüntü oluşturma alanının boyutunu ve konumunu denetlersiniz. Farklı StageWebView nesnelerinin derinlik sıralamasını denetlemenin bir yolu yoktur. İki örneğin örtüşmesi önerilmeyen bir durumdur.
Odak StageWebView nesnesi içindeki içerikte olduğunda, StageWebView nesnesi klavye girişini işlemek için ilk fırsata sahip olur. StageWebView nesnesinin eklendiği sahne alanı, işlenmeyen klavye girişlerini gönderir. StageWebView örneği görüntüleme listesinin bir parçası olmadığından normal olay yakalama/köpürme döngüsü burada geçerli olmaz.
Android 3.0+ uygulamasında, bir uygulama eklenti içeriğini bir StageWebView nesnesinde görüntülemek için AIR uygulama tanımlayıcısının Android manifestAdditions öğesinde donanım hızlandırmayı etkinleştirmelidir.
Daha fazla bilgi
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
isHistoryBackEnabled : Boolean [salt okunur]
Tarama geçmişinde önceki bir sayfanın olup olmadığını bildirir. | StageWebView | ||
isHistoryForwardEnabled : Boolean [salt okunur]
Tarama geçmişinde sonraki bir sayfanın olup olmadığını bildirir. | StageWebView | ||
isSupported : Boolean [statik] [salt okunur]
StageWebView sınıfının geçerli aygıtta desteklenip desteklenmediğini bildirir. | StageWebView | ||
location : String [salt okunur]
Geçerli konumun URL'si. | StageWebView | ||
mediaPlaybackRequiresUserAction : Boolean
Kullanıcının medya içeriğini oynatmak için hareket uygulamasının gerekli olup olmadığını ayarlayın. | StageWebView | ||
stage : Stage
Bu StageWebView nesnesinin görüntülendiği sahne alanı. | StageWebView | ||
title : String [salt okunur]
HTML başlık değeri. | StageWebView | ||
viewPort : Rectangle
StageWebView nesnesinin görüntülendiği sahne alanındaki bölge. | StageWebView |
Yöntem | Tanımlayan: | ||
---|---|---|---|
Bir StageWebView nesnesi oluşturur. | StageWebView | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | EventDispatcher | ||
Bu StageWebView nesnesindeki içeriğe odak atar. | StageWebView | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
Bu StageWebView nesnesini atar. | StageWebView | ||
StageWebView öğesinin görünüm bağlantı noktasını bir bitmap'e çizer. | StageWebView | ||
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Tarama geçmişinde önceki sayfaya gider. | StageWebView | ||
Tarama geçmişinde sonraki sayfaya gider. | StageWebView | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Belirtilen HTML dizesini yükler ve görüntüler. | StageWebView | ||
Belirtilen URL'deki sayfayı yükler. | StageWebView | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
Geçerli sayfayı yeniden yükler. | StageWebView | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
Geçerli yükleme işlemini durdurur. | StageWebView | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object | ||
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher |
Olay | Özet | Tanımlayan: | ||
---|---|---|---|---|
[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | |||
loadString() veya loadURL() yöntemi tarafından istenen son yükleme işleminin tamamlandığını söyler. | StageWebView | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
Bir hata oluştuğunu söyler. | StageWebView | |||
Bu StageWebView nesnesi odağı aldığında gönderilir. | StageWebView | |||
StageWebView odağı bıraktığında gönderilir. | StageWebView | |||
StageWebView nesnesinin location özelliğinin değiştiğini söyler. | StageWebView | |||
StageWebView nesnesinin location özelliğinin değiştirilmek üzere olduğunu söyler. | StageWebView |
isHistoryBackEnabled | özellik |
isHistoryForwardEnabled | özellik |
isSupported | özellik |
location | özellik |
mediaPlaybackRequiresUserAction | özellik |
mediaPlaybackRequiresUserAction:Boolean
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 21.0 |
Kullanıcının medya içeriğini oynatmak için hareket uygulamasının gerekli olup olmadığını ayarlayın. iOS için bu özellik kabul edilmez ve autoPlay ortamı yalnızca StageWebView()
yapıcısı ile gerçekleştirilebilir. Varsayılan değer True şeklindedir.
Uygulama
public function get mediaPlaybackRequiresUserAction():Boolean
public function set mediaPlaybackRequiresUserAction(value:Boolean):void
stage | özellik |
title | özellik |
viewPort | özellik |
viewPort:Rectangle
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
StageWebView nesnesinin görüntülendiği sahne alanındaki bölge.
Uygulama
public function get viewPort():Rectangle
public function set viewPort(value:Rectangle):void
Atar
RangeError — Rectangle değeri geçerli değildir.
|
StageWebView | () | Yapıcı |
public function StageWebView(useNative:Boolean = false, mediaPlaybackRequiresUserAction:Boolean = true)
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Bir StageWebView nesnesi oluşturur.
Bir sahne alanına eklenene ve viewPort
ayarlanana kadar nesne görünmez durumda olur.
Not: Yasak olmasa da, aynı süreç hem gömülü WebKit hem de sistem WebKit'ini kullandığında bazı içeriklerle hatalar oluşabildiğinden belirtilen bir uygulamadaki tüm StageWebView öğelerinin useNative için aynı değere sahip olacak şekilde oluşturulması önerilir. Ayrıca HTMLLoader, gömülü WebKit'e bağlı olduğundan HTMLLoader kullanan uygulamaların StageWebView öğelerini yalnızca useNative öğesi false şeklinde ayarlanmış olarak oluşturması gerekir.
ParametreleruseNative:Boolean (default = false ) — useNative öğesi false olduğunda, AIR içinde gömülü WebKit sürümü oluşturulan StageWebView kaynağı olarak kullanılır. useNative öğesi true olduğunda, AIR sistemin varsayılan web motorunu kullanır. Mobil platformlar yalnızca web motorunun kullanımını desteklediğinden useNative mobil platformlarda yoksayılır.
| |
mediaPlaybackRequiresUserAction:Boolean (default = true ) — true varsayılan değerdir. mediaPlaybackRequiresUserAction değeri true olduğunda WebView, yürütmek için kullanıcı eylemi gerektirir. False ise WebView içeriği otomatik olarak yürütülür.
|
assignFocus | () | yöntem |
public function assignFocus(direction:String = "none"):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Bu StageWebView nesnesindeki içeriğe odak atar.
Yön değerleri FocusDirection sınıfında tanımlıdır ve şunları içerir: "bottom", "none" ve "top".
Parametreler
direction:String (default = "none ") — görüntülenen içerikteki ilk veya son odaklanabilir nesnenin odağı alması gerektiğini belirtir.
|
İlgili API Öğeleri
dispose | () | yöntem |
public function dispose():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Bu StageWebView nesnesini atar.
dispose()
yönteminin çağrılması isteğe bağlıdır. Bu StageWebView örneğine giden bir başvuru yoksa örnek, çöp toplama işlemine uygun hale gelir. dispose()
yönteminin çağrılması, çöp toplama işleminin daha erken veya daha uygun bir zamanda gerçekleşmesini sağlar.
drawViewPortToBitmapData | () | yöntem |
public function drawViewPortToBitmapData(bitmap:BitmapData):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.6 |
StageWebView öğesinin görünüm bağlantı noktasını bir bitmap'e çizer.
StageWebView nesnesinin yukarısında içeriği görüntülemek için bitmap'i yakalayın ve sahne alanını null
değerine ayarlayın.
Not: Bu yöntemin davranışı, eklenti içeriği bulunan sayfalar (örneğin, gömülü PDF ve SWF dosyaları) için garanti edilmemiştir.
Parametreler
bitmap:BitmapData — StageWebView öğesinin görünüm bağlantı noktasının görünür kısmının çizileceği BitmapData nesnesi.
|
Atar
ArgumentError — Bitmap'in genişliği veya yüksekliği, görünüm bağlantı noktasının genişliğinden ya da yüksekliğinden farklıdır.
| |
Error — Bitmap null değerindedir.
|
Örnek ( Bu örnek nasıl kullanılır? )
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 | () | yöntem |
public function historyBack():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Tarama geçmişinde önceki sayfaya gider.
historyForward | () | yöntem |
public function historyForward():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Tarama geçmişinde sonraki sayfaya gider.
loadString | () | yöntem |
public function loadString(text:String, mimeType:String = "text/html"):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Belirtilen HTML dizesini yükler ve görüntüler.
loadString()
yöntemi kullanıldığında location
"about:blank." olarak bildirilir. HTML dizesi içindeki URL'lerde yalnızca standart URI şemaları kullanılabilir. "app:" ve "app-storage:" şeklindeki AIR URI şemalarına izin verilmez.
HTML içeriği, görüntü dosyaları gibi yerel kaynakları yükleyemez. XMLHttpRequest öğelerine izin verilmez.
Yalnızca "text/html" ve "application/xhtml+xml" MIME türleri desteklenir.
Parametreler
text:String — Görüntülenecek HTML veya XHTML içeriği dizesi.
| |
mimeType:String (default = "text/html ") — İçeriğin MIME türü, "text/html" veya "application/xhtml+xml".
|
Örnek ( Bu örnek nasıl kullanılır? )
loadString()
yöntemiyle bir HTML sayfası yüklenir.
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 | () | yöntem |
public function loadURL(url:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Belirtilen URL'deki sayfayı yükler.
URL şu URI şemalarını kullanabilir: http:, https:, file:, data: ve javascript:. file: şemasıyla yüklenen içerik diğer yerel kaynakları yükleyebilir.
Parametreler
url:String |
Örnek ( Bu örnek nasıl kullanılır? )
loadURL()
yöntemiyle bir web sitesi yüklenmektedir.
Not: Android üzerinde, uzak URL'leri yüklemek için AIR uygulama açıklayıcınızda INTERNET izni belirtmeniz gerekir.
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 | () | yöntem |
public function reload():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Geçerli sayfayı yeniden yükler.
stop | () | yöntem |
public function stop():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Geçerli yükleme işlemini durdurur.
complete | Olay |
flash.events.Event
özellik Event.type =
flash.events.Event.COMPLETE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
loadString()
veya loadURL()
yöntemi tarafından istenen son yükleme işleminin tamamlandığını söyler.
Event.COMPLETE
sabiti, complete
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
currentTarget | Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne. |
target | Yüklemesi tamamlanan network nesnesi. |
error | Olay |
flash.events.ErrorEvent
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Bir hata oluştuğunu söyler.
focusIn | Olay |
flash.events.FocusEvent
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
Bu StageWebView nesnesi odağı aldığında gönderilir.
focusOut | Olay |
flash.events.FocusEvent
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
StageWebView odağı bıraktığında gönderilir.
locationChange | Olay |
flash.events.LocationChangeEvent
özellik LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
StageWebView nesnesinin location
özelliğinin değiştiğini söyler.
Olay iptal edilemez.
Her konum değişikliğinden sonra gönderilir. locationChanging | Olay |
flash.events.LocationChangeEvent
özellik LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2.5 |
StageWebView nesnesinin location
özelliğinin değiştirilmek üzere olduğunu söyler.
Yalnızca, HTML içeriğiyle veya StageWebView nesnesi içindeki kod ile konum değişikliği başlatıldığında (bir kullanıcı bir bağlantıyı tıklattığında olduğu gibi) bir locationChanging olayı gönderilir. Varsayılan olarak yeni konum bu StageWebView nesnesinde görüntülenir. Varsayılan davranışı iptal etmek için olay nesnesinin preventDefault()
yöntemini çağırabilirsiniz. Örneğin, olay nesnesinin location
özelliğine göre sayfayı sistem tarayıcısında açmak için flash.net.navigateToURL()
işlevini kullanabilirsiniz
Aşağıdaki yöntemlerle konumu değiştirdiğinizde bir locationChanging olayı gönderilmez.
historyBack()
historyForward()
loadString()
loadURL()
reload()
LOCATION_CHANGING
sabiti, sayfa konumunda bir değişiklik yapılmadan önce LocationChangeEvent nesnesinin gönderdiği type
özelliğinin değerini tanımlar.
loadURL()
yöntemiyle bir web sitesi yüklenir ve geçmişte gezinme için aygıtın Geri ve Ara yazılım tuşları kullanılır.
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:09 PM Z