ProgressEvent  - AS3

Dinleyici olayı işlerken yüklenen öğe veya bayt sayısı.

Yükleme işlemi başarılı olursa yüklenecek toplam öğe veya bayt sayısı. Progress olayı bir Socket nesnesine gönderilirse/eklenirse, yapıcının bytesTotal parametresinde bir değer belirtilmediği sürece bytesTotal her zaman 0 olacaktır. İleri veya geri gönderilen gerçek bayt sayısı ayarlanmaz ve uygulama geliştiricisine bağlıdır.

progress olayları hakkındaki bilgileri içeren bir Event nesnesi oluşturur. Event nesneleri, olay dinleyicilerine parametre olarak iletilir.

ProgressEvent nesnesinin bir kopyasını oluşturur ve her özelliğin değerini, orijinal ile aynı olacak şekilde ayarlar.

ProgressEvent nesnesinin tüm özelliklerini içeren bir dize döndürür. Dize şu biçimdedir:

[ProgressEvent type=value bubbles=value cancelable=value bytesLoaded=value bytesTotal=value]

Bir progress olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

socketData olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bir standardErrorData olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bir standardInputProgress olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Bir standardOutputData olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

1. İndirilen dosyanın konumunu ve adını belirten downloadURL ve fileName özellikleri oluşturulur.
2. ProgressEventExample yapıcısında, file adlı yeni bir FileReference nesnesi oluşturulur ve sonra configureListeners() yöntemine verilir.
3. Ardından downloadURL ve fileName özellikleri file.download() öğesine verilir, bu da dosyanın indirileceği konumu sorar.
4. configureListeners() yöntemi yedi olay dinleyicisi ekler ve bunun ilişkili abone yöntemleri şunlardır:
   1. Dosya indirme işlemi iptal edilirse, cancel/cancelHandler() gönderilir.
   2. Dosya indirme işlemi sona erince complete/complereHandler() gönderilir.
   3. İndirilen dosya kullanılamıyorsa veya erişilemiyorsa ioError/ioErrorHandler() gönderilir.
   4. İndirme işlemi başladığında open/openHandler() gönderilir.
   5. İndirme işlemi başladığında ve tekrar sona erdiğinde progress/progressHandler() gönderilir.
   6. Yerel oynatma güvenlik ayarları, indirilen dosyanın veri erişimi türüyle aynı olmazsa (yerel ve ağ), securityError/securityErrorHandler gönderilir; aşağıdaki notlara bakın:
   7. Download nesnesi seçildiğinde select/selectHandler() gönderilir.

Notlar:

• SWF dosyasını Yerel Oynatma Güvenliği, Yalnızca Yerel Dosyalara Erişim şeklinde ayarlanmış biçimde derlemeniz gerekir.
• Bu örnek SomeFile.pdf adında bir dosya gerektirir.
• Bu örrnek, FileReference nesnesi için kullanılabilir tüm olaylardan yararlansa da, çoğu durum yalnızca bir alt küme gerektirir.

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.FileReference;
    import flash.net.URLRequest;

    public class ProgressEventExample extends Sprite {
        private var downloadURL:String = "http://www.[yourDomain].com/SomeFile.pdf";
        private var fileName:String = "SomeFile.pdf";
        private var file:FileReference;

        public function ProgressEventExample() {
            var request:URLRequest = new URLRequest(downloadURL);
            file = new FileReference();
            configureListeners(file);
            file.download(request, fileName);
        }

        private function configureListeners(dispatcher:IEventDispatcher):void {
            dispatcher.addEventListener(Event.CANCEL, cancelHandler);
            dispatcher.addEventListener(Event.COMPLETE, completeHandler);
            dispatcher.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            dispatcher.addEventListener(Event.OPEN, openHandler);
            dispatcher.addEventListener(ProgressEvent.PROGRESS, progressHandler);
            dispatcher.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler);
            dispatcher.addEventListener(Event.SELECT, selectHandler);
        }

        private function cancelHandler(event:Event):void {
            trace("cancelHandler: " + event);
        }

        private function completeHandler(event:Event):void {
            trace("completeHandler: " + event);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }

        private function openHandler(event:Event):void {
            trace("openHandler: " + event);
        }

        private function progressHandler(event:ProgressEvent):void {
            var file:FileReference = FileReference(event.target);
            trace("progressHandler: name=" + file.name + " bytesLoaded=" + event.bytesLoaded + " bytesTotal=" + event.bytesTotal);
        }

        private function securityErrorHandler(event:SecurityErrorEvent):void {
            trace("securityErrorHandler: " + event);
        }

        private function selectHandler(event:Event):void {
            var file:FileReference = FileReference(event.target);
            trace("selectHandler: name=" + file.name + " URL=" + downloadURL);
        }
    }
}