| Paket | fl.display |
| Sınıf | public class ProLoader |
| Miras Alma | ProLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Not ProLoader, flash.display.Loader öğesinin alt sınıfı değildir. ProLoader öğesini kullanmak için tüm Loader türü başvuruları ProLoader öğesine dönüştürmeniz gerekir.
ProLoader tutarlı bir yükleme deneyimi sunar. Özellikle RSL ön yüklemesini kullanan SWF dosyalarında faydalıdır. Örneğin, TLF metnini kullanan SWF dosyaları varsayılan olarak RSL ön yüklemesini kullanır. Bu durumlarda, ProLoaderInfo INIT veya COMPLETE olaylarının gönderilmesini RSL ön yüklemesi tamamlanana ve gerçek içerik kullanılabilir olana kadar erteler. Sonuç olarak, content özelliği ardından gerçek içeriğe erişebilir. ProLoader ayrıca aşağıdakiler gibi sorunlardan kaçınmanıza da yardımcı olur:
- Fazla
addedToStageveremovedFromStageolayları - İlk karede yanlış üst öğeye yüklenen içerik (Flash Professional CS5.5 veya daha üstü kullanılarak Flash Player 10.2 veya daha üstünde yayınlanmış içerik için geçerlidir).
Uyarı Belirli ProLoader üyeleri tüm çalışma zamanı sürümlerini desteklemez. Bu üyelere yalnızca yayınlanmış AIR veya Flash Player sürümünüz bunları desteklediğinde erişin. Aksi takdirde, bu API'ler çalışma zamanı hataları gönderir. Sınırlı çalışma zamanı desteğine sahip üyeler şu yöntemleri ve özelliği içerir:
-
unloadAndStop() -
loadFilePromise() -
uncaughtErrorEvents
Çalışma zamanı desteğini doğrulamak için her API'nin başvuru konusuna bakın.
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster| Özellik | Tanımlayan: | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
Bu InteractiveObject örneği için geçerli erişilebilirlik uygulaması (AccessibilityImplementation). | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
Bu görüntüleme nesnesi için geçerli erişilebilirlik seçenekleri. | DisplayObject | |
| alpha : Number
Belirtilen nesnenin alfa saydamlık değerini gösterir. | DisplayObject | |
| blendMode : String
Hangi karışım modunun kullanılacağını belirten bir BlendMode sınıfı değeri. | DisplayObject | |
| blendShader : Shader [salt yazılır]
Ön planı ve arka planı karıştırmak için kullanılacak bir gölgelendirici ayarlar. | DisplayObject | |
| buttonMode : Boolean
Bu hareketli grafiğin düğme modunu belirtir. | Sprite | |
| cacheAsBitmap : Boolean
true olarak ayarlanırsa, Flash çalışma zamanları, görüntüleme nesnesinin dahili bir bitmap temsilini önbelleğe alır. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Bu Matrix nesnesi null olmazsa, görüntüleme nesnesinin cacheAsBitmap true olarak ayarlandığı zaman nasıl oluşturacağını tanımlar. | DisplayObject | |
| constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | |
| content : DisplayObject [salt okunur]
load() veya loadBytes() yöntemleri kullanılarak yüklenmiş SWF dosyasının veya görüntü (JPG, PNG ya da GIF) dosyasının kök görüntüleme nesnesini içerir. | ProLoader | ||
| contentLoaderInfo : ProLoaderInfo [salt okunur]
Yüklenmekte olan nesneye karşılık gelen bir ProLoaderInfo nesnesi döndürür. | ProLoader | ||
| contextMenu : NativeMenu
Bu nesneyle ilişkilendirilen bağlam menüsünü belirtir. | InteractiveObject | |
| doubleClickEnabled : Boolean
Nesnenin doubleClick olaylarını alıp almadığını belirtir. | InteractiveObject | |
| dropTarget : DisplayObject [salt okunur]
Hareketli grafiğin üzerine sürüklenmekte olduğu veya hareketli grafiğin üzerine bırakıldığı görüntüleme nesnesini belirtir. | Sprite | |
| filters : Array
Geçerli olarak görüntüleme nesnesiyle ilişkilendirilmiş her filtre nesnesini içeren dizinli bir dizi. | DisplayObject | |
| focusRect : Object
Bu nesnenin bir odak dikdörtgeni görüntüleyip görüntülemediğini belirtir. | InteractiveObject | |
| graphics : Graphics [salt okunur]
Vektör çizimi komutlarının gerçekleşebileceği, bu hareketli grafiğe ait Graphics nesnesini belirtir. | Sprite | |
| height : Number
Görüntüleme nesnesinin yüksekliğini, piksel cinsinden belirtir. | DisplayObject | |
| hitArea : Sprite
Bir hareketli grafik için tıklatma alanı olarak başka bir hareketli grafiği atar. | Sprite | |
| loaderInfo : LoaderInfo [salt okunur]
Bu görüntüleme nesnesinin ait olduğu dosyayı yükleme hakkında bilgi içeren bir LoaderInfo nesnesi döndürür. | DisplayObject | |
| mask : DisplayObject
Çağıran görüntüleme nesnesi belirtilen mask nesnesiyle maskelenir. | DisplayObject | |
| metaData : Object
Meta veri SWF dosyasında PlaceObject4 aracılığıyla söz konusu DisplayObject örneğinin yanında depolanmışsa, DisplayObject örneğinin meta veri nesnesini alır. | DisplayObject | |
| mouseChildren : Boolean
Nesnenin alt öğelerinin, fare veya kullanıcı girdi aygıtı etkin olduğunu belirtir. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Bu nesnenin fare veya diğer kullanıcı girdisi iletileri alıp almadığını belirtir. | InteractiveObject | |
| mouseX : Number [salt okunur]
Farenin veya kullanıcı girdi aygıtı konumunun x koordinatını piksel olarak belirtir. | DisplayObject | |
| mouseY : Number [salt okunur]
Farenin veya kullanıcı girdi aygıtı konumunun y koordinatını piksel olarak belirtir. | DisplayObject | |
| name : String
DisplayObject öğesinin örnek adını belirtir. | DisplayObject | |
| needsSoftKeyboard : Boolean
Bu InteractiveObject örneği odak aldığında sanal bir klavyenin (ekrandaki yazılım klavyesi) görüntülenip görüntülenmemesi gerektiğini belirtir. | InteractiveObject | |
| numChildren : int [salt okunur]
Bu nesnenin alt öğelerinin sayısını döndürür. | DisplayObjectContainer | |
| opaqueBackground : Object
Görüntüleme nesnesinin belirli bir arka plan rengiyle opak olup olmadığını belirtir. | DisplayObject | |
| parent : DisplayObjectContainer [salt okunur]
Bu görüntüleme nesnesini içeren DisplayObjectContainer nesnesini belirtir. | DisplayObject | |
| root : DisplayObject [salt okunur]
Yüklü bir SWF dosyasındaki bir görüntüleme nesnesi için root özelliği, görüntüleme listesi ağaç yapısının o SWF dosyası tarafından temsil edilen kısmındaki en üst görüntüleme nesnesidir. | DisplayObject | |
| rotation : Number
DisplayObject örneğinin başlangıç yönlendirmesinden itibaren döndürülmesini derece olarak belirtir. | DisplayObject | |
| rotationX : Number
DisplayObject örneğinin, 3B üst kabına göre başlangıç yönlendirmesinden itibaren x ekseninde döndürülmesini derece olarak belirtir. | DisplayObject | |
| rotationY : Number
DisplayObject örneğinin, 3B üst kabına göre başlangıç yönlendirmesinden itibaren y ekseninde döndürülmesini derece olarak belirtir. | DisplayObject | |
| rotationZ : Number
DisplayObject örneğinin, 3B üst kabına göre başlangıç yönlendirmesinden itibaren z ekseninde döndürülmesini derece olarak belirtir. | DisplayObject | |
| scale9Grid : Rectangle
Etkin durumdaki geçerli ölçekleme ızgarası. | DisplayObject | |
| scaleX : Number
Nesnenin, kayıt noktasından itibaren uygulandığı haliyle yatay ölçeğini (percentage) belirtir. | DisplayObject | |
| scaleY : Number
Nesnenin kayıt noktasından itibaren uygulandığı haliyle nesnenin dikey ölçeğini (percentage) belirtir. | DisplayObject | |
| scaleZ : Number
Nesnenin kayıt noktasından itibaren uygulandığı haliyle nesnenin derinlik ölçeğini (percentage) belirtir. | DisplayObject | |
| scrollRect : Rectangle
Görüntüleme nesnesinin kaydırma dikdörtgeni sınırları. | DisplayObject | |
| softKeyboard : String
Yazılım klavyesinin görünümünü kontrol eder. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Yazılım klavyesi görüntülendiğinde ekranda kalması gereken alanı belirtir (iOS'ta kullanılabilir değildir) | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Bu hareketli grafikteki sesi denetler. | Sprite | |
| stage : Stage [salt okunur]
Görüntüleme nesnesinin Sahne Alanı. | DisplayObject | |
| tabChildren : Boolean
Nesnenin alt öğelerinin sekme tuşuna tepki verip vermediğini belirler. | DisplayObjectContainer | |
| tabEnabled : Boolean
Bu nesnenin sekme sırasında olup olmadığını belirtir. | InteractiveObject | |
| tabIndex : int
SWF dosyasındaki nesnelerin sekme sıralamasını belirtir. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [salt okunur]
Bu DisplayObjectContainer örneği için bir TextSnapshot nesnesi döndürür. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Bir görüntüleme nesnesinin matrisi, renk dönüşümü ve piksel sınırları ile ilgili özellikleri olan bir nesne. | DisplayObject | |
| uncaughtErrorEvents : EventDispatcher [salt okunur]
Bu ProLoader nesnesinin SWF dosyasındaki kodda işlenmemiş bir hata oluştuğunda bir uncaughtError olayı gönderen nesne. | ProLoader | ||
| useHandCursor : Boolean
İşaret eden elin (el imleci), buttonMode özelliği true değerine ayarlanmış bir hareketli grafiğin üzerinde işaretçi gezinirken görüntülenip görüntülenmeyeceğini belirten Boolean değeri. | Sprite | |
| visible : Boolean
Görüntüleme nesnesinin görünür olup olmadığı. | DisplayObject | |
| width : Number
Görüntüleme nesnesinin genişliğini, piksel cinsinden belirtir. | DisplayObject | |
| x : Number
DisplayObject örneğinin DisplayObjectContainer üst öğesinin yerel koordinatlarına göre x koordinatını belirtir. | DisplayObject | |
| y : Number
DisplayObject örneğinin DisplayObjectContainer üst öğesinin yerel koordinatlarına göre y koordinatını belirtir. | DisplayObject | |
| z : Number
3B üst kabına göre DisplayObject örneğinin z ekseni boyunca z koordinatı konumunu belirtir. | DisplayObject | |
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
SWF, JPEG, GIF veya PNG gibi dosyaları yüklemek için kullanabileceğiniz bir ProLoader nesnesi oluşturur. | ProLoader | ||
|
Bu DisplayObjectContainer örneğine bir alt DisplayObject örneği ekler. | DisplayObjectContainer | |
|
Bu DisplayObjectContainer örneğine bir alt DisplayObject örneği ekler. | DisplayObjectContainer | |
| 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 | |
|
Güvenlik kısıtlamalarının, DisplayObjectContainer.getObjectsUnderPoint() yönteminin belirtilen point noktası ile çağrılması sonucunda döndürülen listeden görüntüleme nesnelerinin çıkarılmasına neden olup olmayacağını belirtir. | DisplayObjectContainer | |
ProLoader örneği için devam eden bir load() yöntemi işlemini iptal eder. | ProLoader | ||
|
Belirtilen görüntüleme nesnesinin, DisplayObjectContainer örneğinin alt öğesi mi, yoksa örneğin kendisi mi olduğunu belirler. | DisplayObjectContainer | |
|
Olay akışına bir olay gönderir. | EventDispatcher | |
|
Görüntüleme nesnesinin alanını targetCoordinateSpace nesnesinin koordinat sistemine göre tanımlayan bir dikdörtgen döndürür. | DisplayObject | |
|
Belirtilen dizinde bulunan alt görüntüleme nesnesi örneğini döndürür. | DisplayObjectContainer | |
|
Belirtilen ad ile var olan alt görüntüleme nesnesini döndürür. | DisplayObjectContainer | |
|
Bir alt DisplayObject örneğinin dizin konumunu döndürür. | DisplayObjectContainer | |
|
Belirtilen noktanın altında olan ve bu DisplayObjectContainer örneğinin alt öğesi (veya alt alt öğesi vb.) olan nesnelerin bir dizisini döndürür. | DisplayObjectContainer | |
|
targetCoordinateSpace parametresince tanımlanan koordinat sistemini esas alarak ve her tür çizgi ve şekli dışarıda bırakarak görüntüleme nesnesinin sınırlarını tanımlayan bir dikdörtgen döndürür. | DisplayObject | |
|
point nesnesini, Sahne Alanı (global) koordinatlarından görüntüleme nesnesinin (yerel) koordinatlarına dönüştürür. | DisplayObject | |
|
Sahne Alanı (global) koordinatlarından iki boyutlu noktayı üç boyutlu görüntüleme nesnesinin (yerel) koordinatlarına dönüştürür. | DisplayObject | |
|
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 | |
|
obj görüntüleme nesnesinin sınırlayıcı kutusuyla örtüşüp örtüşmediğini veya kesişip kesişmediğini görmek için görüntüleme nesnesinin sınırlayıcı kutusunu değerlendirir. | DisplayObject | |
|
Görüntüleme nesnesinin x ve y parametreleriyle belirtilen noktayla örtüştüğünü veya kesiştiğini görmek için görüntüleme nesnesini değerlendirir. | DisplayObject | |
|
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | |
Bu ProLoader nesnesinin alt öğesi olan bir nesneye bir SWF, JPEG, aşamalı JPEG, animasyonsuz GIF veya PNG dosyası yükler. | ProLoader | ||
Bir ByteArray nesnesinde saklanan ikili veriyi yükler. | ProLoader | ||
Promise parametresi aracılığıyla bir IFilePromise örneği yükler. | ProLoader | ||
|
Üç boyutlu görüntüleme nesnesinin (yerel) koordinatlarının üç boyutlu noktasını, Sahne Alanı (global) koordinatlarındaki iki boyutlu noktaya dönüştürür. | DisplayObject | |
|
point nesnesini, görüntüleme nesnesinin (yerel) koordinatlarından Sahne Alanı (global) koordinatlarına dönüştürür. | DisplayObject | |
|
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | |
|
Belirtilen alt DisplayObject örneğini DisplayObjectContainer örneğinin alt öğe listesinden kaldırır. | DisplayObjectContainer | |
|
DisplayObjectContainer nesnesinin alt öğe listesinde belirtilen dizin konumundan bir alt DisplayObject öğesini kaldırır. | DisplayObjectContainer | |
|
Tüm alt DisplayObject örneklerini DisplayObjectContainer örneğinin alt öğe listesinden kaldırır. | DisplayObjectContainer | |
|
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | |
|
Sanal bir klavye yükseltir. | InteractiveObject | |
|
Mevcut bir alt öğenin görüntüleme nesnesi kabındaki konumunu değiştirir. | DisplayObjectContainer | |
|
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | |
|
Kullanıcının belirtilen hareketli grafiği sürüklemesini sağlar. | Sprite | |
|
Kullanıcının dokunmatik etkin bir aygıtta belirli hareketli grafiği sürüklemesine izin verir. | Sprite | |
|
Kökü bu nesnede bulunan tüm MovieClip öğelerinin zaman çizelgesinde yürütülmesini özyinelemeli olarak durdurur. | DisplayObjectContainer | |
|
startDrag() yöntemini bitirir. | Sprite | |
|
Dokunma etkin aygıtlarla kullanım için startTouchDrag() yöntemini sonlandırır. | Sprite | |
|
Belirtilen iki alt nesnenin z sırasını (önden arkaya sıra) takas eder. | DisplayObjectContainer | |
|
Alt öğe listesinde belirtilen iki dizin konumundaki alt öğe nesnelerinin z sırasını (önden arkaya sıra) takas eder. | DisplayObjectContainer | |
|
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 | |
Bu ProLoader nesnesinin load() yöntemi kullanılarak yüklenmiş bir alt öğesini kaldırır. | ProLoader | ||
|
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 | |
content | özellik |
content:DisplayObject [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
load() veya loadBytes() yöntemleri kullanılarak yüklenmiş SWF dosyasının veya görüntü (JPG, PNG ya da GIF) dosyasının kök görüntüleme nesnesini içerir.
Uygulama
public function get content():DisplayObjectAtar
SecurityError — Yüklenen SWF dosyası veya görüntü dosyası, erişiminiz olmayan bir güvenlik sanal alanına aittir. Yüklenen bir SWF dosyası için, dosyanın Security.allowDomain() yöntemini çağırmasını sağlayarak veya load() ya da loadBytes() yöntemini çağırdığınızda securityDomain özelliği SecurityDomain.currentDomain değerine ayarlı durumdayken yükleme dosyasının bir loaderContext parametresi belirtmesini sağlayarak bu durumu önleyebilirsiniz.
|
contentLoaderInfo | özellik |
contentLoaderInfo:ProLoaderInfo [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Yüklenmekte olan nesneye karşılık gelen bir ProLoaderInfo nesnesi döndürür. ProLoaderInfo nesneleri ProLoader nesnesi ile yüklenen content nesnesi arasında paylaşılır. ProLoaderInfo nesnesi, yükleme ilerleme bilgilerini ve yüklenen dosya hakkında istatistikleri sağlar.
Yüklemeyle ilgili olaylar, ProLoader nesnesinin contentLoaderInfo özelliğinin başvurduğu ProLoaderInfo nesnesi tarafından gönderilir. Yükleme öncesinde nesneye olay dinleyicileri ekleyebilmeniz için, içerik daha yüklenmeden önce contentLoaderInfo özelliği geçerli bir ProLoaderInfo nesnesine ayarlanır.
Yüklü bir SWF'de oluşan yakalanmamış hataları algılamak için ProLoader.contentLoaderInfo.uncaughtErrorEvents özelliğine değil, ProLoader.uncaughtErrorEvents özelliğine bakın.
Not contentLoaderInfo özelliği bir ProLoaderInfo nesnesi döndürür. ProLoaderInfo nesnesi LoaderInfo öğesinin alt sınıfı değildir ve bu nedenle size üst sınıfa yapılacak örtük atamanın faydasını sağlamaz. Bu nedenle, tür bildirimlerinizi LoaderInfo öğesinden ProLoaderInfo öğesine değiştirdiğinizden emin olun.
Uygulama
public function get contentLoaderInfo():ProLoaderInfouncaughtErrorEvents | özellik |
uncaughtErrorEvents:EventDispatcher [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2.0 |
Bu ProLoader nesnesinin SWF dosyasındaki kodda işlenmemiş bir hata oluştuğunda bir uncaughtError olayı gönderen nesne. Herhangi bir try..catch bloğunun dışında bir hata atıldığında veya herhangi bir lisanslı dinleyiciye sahip olmayan bir ErrorEvent nesnesi gönderildiğinde yakalanmayan bir hata oluşur.
Bu özellik, bu nesneyle ilişkin SWF'nin yüklenmesi bittiğinde oluşturulur. O zamana kadar, uncaughtErrorEvents özelliği null kalır. Bir salt ActionScript projesinde, SWF dosyasının ana sınıfının yapıcı işlevinin yürütülmesi sırasında veya işlev yürütüldükten sonra bu özelliğe erişebilirsiniz.
Kendisini desteklemeyen bir oynatıcıda bu ProLoader özelliğine erişilmesi bir hataya yol açar. Desteklemeyen oynatıcılarda hata meydana gelmesini önlemek için UncaughtErrorEvents nesnesi yerine bir EventDispatcher nesnesini döndürür.
Uygulama
public function get uncaughtErrorEvents():EventDispatcherİlgili API Öğeleri
ProLoader | () | Yapıcı |
public function ProLoader()| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
SWF, JPEG, GIF veya PNG gibi dosyaları yüklemek için kullanabileceğiniz bir ProLoader nesnesi oluşturur. ProLoader örneğinin bir alt öğesi olarak varlığı yüklemek için load() yöntemini çağırın. Daha sonra ProLoader nesnesini görüntüleme listesine ekleyebilirsiniz (örneğin, bir DisplayObjectContainer örneğinin addChild() yöntemini kullanarak). Varlık yüklendiğinde sahne alanı üzerinde görüntülenir.
Bir ProLoader örneğini görüntüleme listesindeki bir görüntüleme nesnesi kabına eklemeden de "liste dışı" şekilde kullanabilirsiniz. Bu modda, bir uygulamanın ek modüllerini içeren bir SWF dosyasını yüklemek için Loader örneği kullanılabilir.
SWF dosyasının yüklemeyi bitirdiği zamanı algılamak için, ProLoaderInfo nesnesinin, ProLoader nesnesinin contentLoaderInfo özelliğiyle ilişkili olaylarını kullanabilirsiniz. Bu noktada, SWF dosyasındaki modülde bulunan kod, modülü başlatmak için çalıştırılabilir. Liste dışı modunda, bileşenleri veya medya varlıklarını içeren bir SWF dosyasını yüklemek için bir ProLoader örneği de kullanılabilir. Ayrıca, bileşenlerin yüklenmesinin bittiği zamanı algılamak için ProLoaderInfo nesnesinin olay bildirimlerini kullanabilirsiniz. Bu noktada uygulama, SWF dosyasının kütüphanesindeki bileşenleri ve medya varlıklarını temsil eden ActionScript 3.0 sınıflarını başlatıp bu bileşenleri ve varlıkları kullanarak başlatılabilir.
Bir ProLoader nesnesinin durumunu belirlemek için, ProLoaderInfo nesnesinin ProLoader nesnesinin contentLoaderInfo özelliğiyle ilişkilendirdiği şu olayları izleyin:
- Yükleme başladığında
openolayı gönderilir. - Dosya yüklenemezse veya yükleme işlemi sırasında bir hata oluşursa,
ioErrorya dasecurityErrorolayı gönderilir. - Dosya yüklenirken sürekli olarak
progressolayı tetiklenir. - Bir dosyanın indirilmesi tamamlandığında, ancak yüklenen film klibinin yöntemleri ve özellikleri kullanılabilir duruma geçmeden önce
completeolayı gönderilir. Yüklü bir SWF dosyası RSL ön yüklemesini kullanıyorsa, bu olay RSL ön yüklemesi tamamlandıktan sonra gönderilir. Bu noktada, gerçek içerikcontentözelliğinde mevcuttur. - Yüklenen SWF dosyasının özellikleri ve yöntemleri erişilebilir olduktan sonra
initolayı gönderilir, böylece yüklenen SWF dosyasını işleyebilirsiniz.completeişleyiciden önce bu olay gönderilir. SWF dosyalarının akışında,completeolayından çok önceinitolayı oluşabilir. Birçok amaç içininitişleyiciyi kullanın. Yüklü bir SWF dosyası RSL ön yüklemesini kullanıyorsa, bu olay RSL ön yüklemesi tamamlandıktan sonra gönderilir. Bu noktada, gerçek içerikcontentözelliğinde mevcuttur.
İlgili API Öğeleri
close | () | yöntem |
public function close():void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player Player - 9 |
ProLoader örneği için devam eden bir load() yöntemi işlemini iptal eder.
load | () | yöntem |
public function load(request:URLRequest, context:LoaderContext = null):void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0, Flash Player Player - 9 |
Bu ProLoader nesnesinin alt öğesi olan bir nesneye bir SWF, JPEG, aşamalı JPEG, animasyonsuz GIF veya PNG dosyası yükler. Animasyonlu bir GIF dosyası yüklerseniz, yalnızca birinci kare görüntülenir. ProLoader nesnesi yalnızca bir alt öğe içerebildiğinden, sonraki load() isteklerinin başlatılması, halen beklemedeyse bir önceki isteği sonlandırır ve yeni bir yükleme başlatır.
Not: AIR 1.5 ve Flash Player 10'da, yüklenen bir görüntü için maksimum boyut genişlik ve yükseklikte 8.191 pikseldir ve toplam piksel sayısı 16.777.215'i geçemez. (Bu nedenle, yüklenen bir görüntü 8.191 piksel genişliğindeyse en fazla 2.048 piksel yüksekliğinde olabilir.) Flash Player 9 ve önceki sürümleri ile AIR 1.1 ve önceki sürümlerinde, sınırlama yükseklikte 2.880 piksel ve genişlikte 2.880 pikseldir.
ProLoader nesnesine yüklenen bir SWF dosyası veya görüntü, ProLoader nesnesinin üst görüntüleme nesnelerinin position, rotation ve scale özelliklerini miras alır.
Bu yöntemle yüklenen filmleri veya görüntüleri kaldırmak ya da devam eden bir yükleme işlemini iptal etmek için unload() yöntemini kullanın.
SWF içeriğini barındıran HTML sayfasındaki object veembed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz.
Bu yöntemi kullanırken, ProLoader sınıfı açıklamasında açıklanan Flash Player güvenlik modelini aklınızda bulundurun.
Flash Player 10 ve sonrasında, yükleme (POST gövdesi içinde "content-disposition" başlığında "filename" parametresiyle belirtilir) içeren çok bölümlü bir Content-Type (örneğin, "multipart/form-data") kullanırsanız, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabidir:
- Fare tıklatma veya tuş basışı gibi kullanıcı tarafından başlatılan bir eyleme yanıt olarak POST işleminin gerçekleştirilmesi gerekir.
- POST işlemi etki alanları arasıysa (POST hedefi, POST isteğini gönderen SWF dosyasıyla aynı sunucuda değilse), hedef sunucunun etki alanları arası erişime izin veren bir URL ilke dosyası sağlaması gerekir.
Ayrıca çok bölümlü herhangi bir Content-Type için sözdiziminin geçerli olması gerekir (RFC2046 standardına göre). Sözdizimi geçersiz görünüyorsa, POST işlemi, yüklemelere uygulanan güvenlik kurallarına tabi olur.
Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.
Parametreler
request:URLRequest — Yüklenecek SWF, JPEG, GIF veya PNG dosyasının mutlak ya da göreceli URL'si. Göreceli bir yolun ana SWF dosyasıyla ilişkili olması gerekir. Mutlak URL'lerin http:// veya file:/// gibi protokol başvurusu içermesi gerekir. Dosya adları, disk sürücüsü belirtimlerini içeremez.
| |
context:LoaderContext (default = null)
Tüm ayrıntılar için, LoaderContext sınıfındaki özelliklerin açıklamasına bakın. |
Olaylar
asyncError: — LoaderContext.requestedContentParent özelliği belirtildiyse ve yüklenen içeriğin belirtilen DisplayObjectContainer öğesine bir alt öğe olarak eklenmesi mümkün değilse, contentLoaderInfo nesnesi tarafından gönderilir. Yüklenen içerik bir flash.display.AVM1Movie ise veya requestedContentParent öğesine yapılan addChild() çağrısı bir hata gönderirse bu gerçekleşebilir.
| |
complete: — Dosya yüklemesi tamamlandığında contentLoaderInfo nesnesi tarafından gönderilir. complete olayı her zaman init olayından sonra gönderilir.
| |
httpStatus: — HTTP üzerinden bir ağ isteği yapıldığında ve Flash Player, HTTP durum kodunu algılayabildiğinde contentLoaderInfo nesnesi tarafından gönderilir.
| |
init: — Yüklenen SWF dosyasının özellikleri ve yöntemleri erişilebilir olduğunda contentLoaderInfo nesnesi tarafından gönderilir. init olayı her zaman complete olayından önce gerçekleşmelidir.
| |
ioError: — Bir yükleme işleminin başarısız olmasına neden olan bir girdi veya çıktı hatası oluştuğunda contentLoaderInfo nesnesi tarafından gönderilir.
| |
open: — Yükleme işlemi başladığında contentLoaderInfo nesnesi tarafından gönderilir.
| |
progress: — Yükleme işlemi devam ederken veri alındığında contentLoaderInfo nesnesi tarafından gönderilir.
| |
securityError: — Dosya sistemine sahip yerel sanal alandaki bir SWF dosyası, ağ iletişimine sahip yerel sanal alandaki içeriği yüklemeye çalışırsa veya tam tersi bir durumda contentLoaderInfo nesnesi tarafından gönderilir.
| |
securityError: — LoaderContext.requestedContentParent özelliği belirtildiyse ve LoaderContext.requestedContentParent öğesinin güvenlik sanal alanının yüklenen SWF'ye erişimi yoksa, contentLoaderInfo nesnesi tarafından gönderilir.
| |
unload: — Yüklenen bir nesne kaldırıldığında contentLoaderInfo nesnesi tarafından gönderilir.
|
Atar
IOError — request nesnesinin digest özelliği null değildir. SWZ dosyası (bir Adobe platformu bileşeni) yüklenirken URLLoader.load() yöntemi çağrıldığında yalnızca URLRequest nesnesinin digest özelliğini ayarlamalısınız.
| |
SecurityError — LoaderContext.securityDomain öğesinin değeri null veya SecurityDomain.currentDomain olmalıdır. Bu, yüklenen medyayı yalnızca onun doğal güvenlik sanal alanına veya kendinizinkine (kendi güvenlik sanal alanınıza yerleştirmeniz için ilke dosyası gerekir) yerleştirebileceğiniz gerçeğini yansıtır.
| |
SecurityError — Yerel SWF dosyaları, LoaderContext.securityDomain öğesini null dışında bir değere ayarlamayabilir. Yerel olmayan medyaların yerel sanal alanına aktarılmasına veya diğer yerel ortamların kendi doğal sanal alanlar dışında bir yere yerleştirilmesine izin verilmez.
| |
SecurityError — Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.
| |
SecurityError — context parametresinin applicationDomain veya securityDomain özellikleri izin verilmeyen bir etki alanından geliyorsa.
| |
SecurityError — Yerel bir SWF dosyası, context parametresinin securityDomain özelliğini kullanmaya çalışıyorsa.
| |
IllegalOperationError — context parametresinin requestedContentParent özelliği ProLoader olursa.
| |
IllegalOperationError — LoaderContext.parameters parametresi boş olmayan bir değere ayarlanırsa ve Dize olmayan bazı değerler içerirse.
|
İlgili API Öğeleri
loadBytes | () | yöntem |
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0, Flash Player 9 |
Bir ByteArray nesnesinde saklanan ikili veriyi yükler.
loadBytes() yöntemi senkronize değildir. Yüklenmiş nesnenin özeliklerine ulaşmadan önce "init" olayını beklemeniz gerekir.
Bu yöntemi kullanırken, ProLoader sınıfı açıklamasında açıklanan Flash Player güvenlik modelini aklınızda bulundurun.
Parametreler
bytes:ByteArray — Bir ByteArray nesnesi. ByteArray öğesinin içerikleri ProLoader sınıfı tarafından desteklenen şu dosya biçimlerinden herhangi biri olabilir: SWF, GIF, JPEG veya PNG.
| |
context:LoaderContext (default = null)applicationDomain özelliği uygulanır; LoaderContext nesnesinin checkPolicyFile ve securityDomain özellikleri uygulanmaz.
Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik. |
Olaylar
asyncError: — LoaderContext.requestedContentParent özelliği belirtildiyse ve yüklenen içeriğin belirtilen DisplayObjectContainer öğesine bir alt öğe olarak eklenmesi mümkün değilse, contentLoaderInfo nesnesi tarafından gönderilir. Yüklenen içerik bir flash.display.AVM1Movie ise veya requestedContentParent öğesine yapılan addChild() çağrısı bir hata gönderirse bu gerçekleşebilir.
| |
complete: — İşlem tamamlandığında contentLoaderInfo nesnesi tarafından gönderilir. complete olayı her zaman init olayından sonra gönderilir.
| |
init: — Yüklenen verilerin özellikleri ve yöntemleri erişilebilir olduğunda contentLoaderInfo nesnesi tarafından gönderilir. init olayı her zaman complete olayından önce gerçekleşmelidir.
| |
ioError: — Çalışma zamanı bayt dizisindeki veriyi ayrıştıramadığında contentLoaderInfo nesnesi tarafından gönderilir.
| |
open: — İşlem başladığında contentLoaderInfo nesnesi tarafından gönderilir.
| |
progress: — Veri belleğe aktarılırken contentLoaderInfo nesnesi tarafından gönderilir.
| |
securityError: — LoaderContext.requestedContentParent özelliği belirtildiyse ve LoaderContext.requestedContentParent öğesinin güvenlik sanal alanının yüklenen SWF'ye erişimi yoksa, contentLoaderInfo nesnesi tarafından gönderilir.
| |
unload: — Yüklenen bir nesne kaldırıldığında contentLoaderInfo nesnesi tarafından gönderilir.
|
Atar
ArgumentError — ByteArray nesnesinin length özelliği 0'dan büyük değilse.
| |
IllegalOperationError — context parametresinin checkPolicyFile veya securityDomain özelliği non-null ise.
| |
IllegalOperationError — context parametresinin requestedContentParent özelliği ProLoader olursa.
| |
IllegalOperationError — LoaderContext.parameters parametresi boş olmayan bir değere ayarlanırsa ve Dize olmayan bazı değerler içerirse.
| |
SecurityError — context özelliğinin sağlanan applicationDomain özelliği izin verilmeyen bir etki alanındaysa.
| |
SecurityError — Ortak olarak ayrılmış bağlantı noktalarına bağlanamazsınız. Engellenen bağlantı noktalarının tam listesi için, bkz. "Ağ İletişimi API'lerini Kısıtlama", ActionScript 3.0 Geliştirici Kılavuzu.
|
İlgili API Öğeleri
loadFilePromise | () | yöntem |
public function loadFilePromise(promise:Object, context:LoaderContext = null):void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | AIR 2.5, AIR 2.0, Flash Player 9 |
promise parametresi aracılığıyla bir IFilePromise örneği yükler. promise parametresi türü diğer oynatıcılardaki hataları önlemek için IFilePromise yerine Object üst sınıfını kullanır.
loadFilePromise yöntemi bir IFilePromise nesnesini alır ve ikili veriyi yükler. Veri video gibi aşamalı bir akışsa yüklenen nesnenin özelliklerine erişmeden önce "init" öğesini veya progress olaylarını bekleyin. Aksi takdirde, verinin tamamen yüklendiğinden emin olmak için complete olayını bekleyin.
Bu yöntemi kullanırken, ProLoader sınıfı açıklamasında açıklanan Flash Player güvenlik modelini aklınızda bulundurun.
Parametreler
promise:Object — Bir IFilePromise nesnesi. Nesnenin veri kaynağı ProLoader sınıfı tarafından desteklenen dosya biçimlerinden herhangi biri olabilir: SWF, GIF, JPEG veya PNG.
| |
context:LoaderContext (default = null)applicationDomain özelliği uygulanır; LoaderContext nesnesinin checkPolicyFile ve securityDomain özellikleri uygulanmaz.
Güvenlikle ilgili daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik. |
Olaylar
asyncError: — LoaderContext.requestedContentParent özelliği belirtildiyse ve yüklenen içeriğin belirtilen DisplayObjectContainer öğesine bir alt öğe olarak eklenmesi mümkün değilse, contentLoaderInfo nesnesi tarafından gönderilir. Yüklenen içerik bir flash.display.AVM1Movie ise veya requestedContentParent öğesine yapılan addChild() çağrısı bir hata gönderirse bu gerçekleşebilir.
| |
complete: — İşlem tamamlandığında contentLoaderInfo nesnesi tarafından gönderilir. complete olayı her zaman init olayından sonra gönderilir.
| |
init: — Yüklenen verilerin özellikleri ve yöntemleri erişilebilir olduğunda contentLoaderInfo nesnesi tarafından gönderilir. init olayı her zaman complete olayından önce gerçekleşmelidir.
| |
ioError: — Çalışma zamanı veri kaynağındaki veriyi ayrıştıramadığında veya veri kaynağı akışı okunabilir durumda olmadığında contentLoaderInfo nesnesi tarafından gönderilir.
| |
open: — İşlem başladığında contentLoaderInfo nesnesi tarafından gönderilir.
| |
progress: — Veri belleğe aktarılırken contentLoaderInfo nesnesi tarafından gönderilir.
| |
securityError: — LoaderContext.requestedContentParent özelliği belirtildiyse ve LoaderContext.requestedContentParent öğesinin güvenlik sanal alanının yüklenen SWF'ye erişimi yoksa, contentLoaderInfo nesnesi tarafından gönderilir.
| |
unload: — Yüklenen bir nesne kaldırıldığında contentLoaderInfo nesnesi tarafından gönderilir.
Uyarı Bir AIR uygulamasında değilken bu API'ye erişilmesi bir hataya neden olur. |
Atar
IllegalOperationError — context parametresinin requestedContentParent özelliği ProLoader olursa.
| |
IllegalOperationError — LoaderContext.parameters parametresi boş olmayan bir değere ayarlanırsa ve Dize olmayan bazı değerler içerirse.
| |
ArgumentError — Parametre olarak iletilen IFilePromise nesnesi null değerinde olursa
|
İlgili API Öğeleri
unload | () | yöntem |
public function unload():void| Dil Sürümü: | ActionScript 3.0 |
| Ürün Sürümü: | Flash CS5.5 |
| Çalışma Zamanı Sürümleri: | AIR 1.0, Flash Player 9 |
Bu ProLoader nesnesinin load() yöntemi kullanılarak yüklenmiş bir alt öğesini kaldırır. İlişkilendirilmiş ProLoaderInfo nesnesinin property özelliği null değerine sıfırlanır. Diğer nesnelerin alt öğeye başvurusu olduğu için alt öğenin mutlaka yok edilmesi gerekmez; ancak bu artık ProLoader nesnesinin bir alt öğesi olmaz.
En iyi uygulama olarak, alt SWF dosyasını kaldırmadan önce alt SWF dosyasının LocalConnection, NetConnection, NetStream ve Sound gibi nesnelerindeki tüm akışları açıkça kapatmanız gerekir. Aksi takdirde, alt SWF dosyası kaldırıldığı halde alt SWF dosyasındaki ses çalmaya devam edebilir. Alt SWF dosyasındaki akışları kapatmak için, unload olayını dinleyen alt öğeye bir olay dinleyicisi ekleyin. Üst öğe ProLoader.unload() öğesini çağırdığında, alt öğeye unload olayı gönderir. Şu kod, bunu nasıl yapabileceğinizi gösterir:
function closeAllStreams(evt:Event) {
myNetStream.close();
mySound.close();
myNetConnection.close();
myLocalConnection.close();
}
myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);
İlgili API Öğeleri
Tue Jun 12 2018, 01:09 PM Z