EventDispatcher  - AS3

EventDispatcher sınıfının bir örneğini gruplar.

EventDispatcher sınıfı genellikle temel sınıf olarak kullanılır, başka bir deyişle çoğu geliştiricinin bu yapıcı işlevini kullanması gerekmez. Ancak IEventDispatcher arabirimini uygulayan ileri düzey geliştiricilerin bu yapıcıyı kullanması gerekmez. EventDispatcher sınıfını genişletemiyorsanız ve bunun yerine IEventDispatcher arabirimini uygulamanız gerekiyorsa, EventDispatcher sınıfının bir örneğini toplamak için bu yapıcıyı kullanın.

EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. Belirli türde bir olay, aşama ve öncelik için görüntüleme listesindeki tüm düğümlere olay dinleyicilerini kaydedebilirsiniz.

Bir olay dinleyicisini başarıyla kaydettikten sonra, addEventListener() öğesine ek çağrılar yaparak önceliğini değiştiremezsiniz. Bir dinleyicinin önceliğini değiştirmek için, ilk olarak removeListener() öğesini çağırmanız gerekir. Daha sonra dinleyiciyi yeni öncelik seviyesiyle kaydedebilirsiniz.

Dinleyici kaydedildikten sonra, farklı bir type veya useCapture değeriyle addEventListener() öğesine yapılan çağrılar, ayrı bir dinleyici kaydının oluşturulmasıyla sonuçlanır. Örneğin, ilk olarak useCapture true değerine ayarlanmış durumdayken bir dinleyiciyi kaydederseniz, dinleyici yalnızca yakalama aşaması boyunca dinleme işlemi yapar. Aynı dinleyici nesnesini kullanarak, ancak useCapture false değerine ayarlanmış durumdayken tekrar addEventListener() öğesini çağırırsanız, iki ayrı dinleyiciniz olur: bunlardan biri yakalama aşamasında dinleme işlemi yapar, diğeri ise hedef ve köpürme aşamasında dinleme işlemi yapar.

Yalnızca hedef aşaması veya köpürme aşaması için bir olay dinleyicisini kaydedemezsiniz. Köpürme yalnızca hedef düğümün alt öğeleri için geçerli olduğundan, bu aşamalar kayıt sırasında birleştirilir.

Artık bir olay dinleyicisine ihtiyacınız olmadığında, removeEventListener() öğesini çağırarak olay dinleyicisini kaldırın, aksi takdirde bellek sorunları oluşabilir. Çöp toplayıcısı, gönderen nesne var olduğu sürece dinleyiciyi kaldırmadığından, (useWeakReference parametresi true olarak ayarlı değilse) olay dinleyicileri otomatik olarak bellekten kaldırılmaz.

Bir EventDispatcher örneği kopyalandığında, o örneğe ekli olan olay dinleyicileri kopyalanmaz. (Yeni oluşturulmuş düğümünüz için bir olay dinleyicisi gerekiyorsa, düğümü oluşturduktan sonra dinleyiciyi eklemeniz gerekir.) Ancak bir EventDispatcher örneğini taşırsanız, örneğe ekli olan olay dinleyicileri de onunla birlikte taşınır.

Bir olay düğümde işlenirken olay dinleyicisi o düğüme kaydediliyorsa, geçerli aşama sırasında olay dinleyicisi tetiklenmez ancak olay akışındaki köpürme aşaması gibi sonraki bir aşamada tetiklenebilir.

Bir olay düğümde işlenirken olay dinleyicisi o düğümden kaldırılırsa, geçerli eylemler tetiklenmeye devam eder. Olay dinleyicisi kaldırıldıktan sonra asla tekrar çağrılmaz (ileride işlenmek üzere tekrar kaydedilmediği sürece).

Parametreler

function(evt:Event):void

Olay akışına bir olay gönderir. Olay hedefi, dispatchEvent() yönteminin çağrıldığı EventDispatcher nesnesidir.

Parametreler

EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. Bu, EventDispatcher nesnesinin olay akışı hiyerarşisindeki bir event türünün işlenmesini nerede değiştirdiğini belirlemenize izin verir. Belirli türde bir olayın olay dinleyicisini gerçekten tetikleyip tetiklemeyeceğini belirlemek için willTrigger() öğesini kullanın.

hasEventListener() ile willTrigger() arasındaki fark, hasEventListener() öğesi yalnızca ait olduğu nesneyi incelerken willTrigger() öğesinin type parametresi ile belirtilen olayın tüm olay akışını incelemesidir.

LoaderInfo nesnesinden hasEventListener() çağrıldığında, yalnızca çağıranın erişebildiği dinleyiciler değerlendirilir.

Parametreler

İlgili API Öğeleri

EventDispatcher nesnesinden bir dinleyiciyi kaldırır. EventDispatcher nesnesiyle kayıtlı eşlenen bir dinleyici yoksa, bu yönteme yapılan çağrının herhangi bir etkisi yoktur.

Parametreler

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. Belirtilen türde bir olay bu EventDispatcher nesnesine veya herhangi bir alt öğesine gönderildiğinde olay akışının herhangi bir aşamasında bir olay dinleyicisi tetiklenirse, bu yöntem true döndürür.

hasEventListener() ile willTrigger() yöntemleri arasındaki fark, hasEventListener() yöntemi yalnızca ait olduğu nesneyi incelerken willTrigger() yönteminin type parametresi ile belirtilen olayın tüm olay akışını incelemesidir.

LoaderInfo nesnesinden willTrigger() çağrıldığında, yalnızca çağıranın erişebildiği dinleyiciler değerlendirilir.

Parametreler

[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. Bu olay bir broadcast olayıdır; diğer bir deyişle, bu olay kendisi için kaydedilmiş bir dinleyiciye sahip tüm EventDispatcher nesneleri tarafından gönderilir. Broadcast olayları hakkında daha fazla bilgi için bkz. DisplayObject sınıfı.

Not: Bu olayda “yakalama aşaması“ veya “köpürme aşaması“ bulunmaz; başka bir deyişle, olay dinleyicileri her türlü potansiyel hedefe, hedefler görüntüleme listesinde olsun veya olmasın, doğrudan eklenmelidir.

AIR for TV aygıtları hiçbir zaman otomatik olarak bu olayı göndermez. Ancak olayı el ile gönderebilirsiniz.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. Bu olay bir broadcast olayıdır; diğer bir deyişle, bu olay kendisi için kaydedilmiş bir dinleyiciye sahip tüm EventDispatcher nesneleri tarafından gönderilir. Broadcast olayları hakkında daha fazla bilgi için bkz. DisplayObject sınıfı.

Not: Bu olayda “yakalama aşaması“ veya “köpürme aşaması“ bulunmaz; başka bir deyişle, olay dinleyicileri her türlü potansiyel hedefe, hedefler görüntüleme listesinde olsun veya olmasın, doğrudan eklenmelidir.

AIR for TV aygıtları hiçbir zaman otomatik olarak bu olayı göndermez. Ancak olayı el ile gönderebilirsiniz.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

1. EventDispatcherExample yapıcısı, dispatcher yerel değişkenini oluşturur ve bunu yeni bir CustomDispatcher örneğine atar.
2. CustomDispatcher içinde, olayın adı action olacak ve doAction() yöntemi bildirilecek şekilde bir dize ayarlanır. Bu yöntem çağrıldığında action olayını oluşturur ve EventDispatcher.dispatchEvent() öğesini kullanarak bu olayı gönderir.
3. Daha sonra action olay dinleyicisini ve gönderildiğinde olay hakkındaki bilgileri yazdıran ilişkili actionHandler() subscriber yöntemini eklemek için dispatcher özelliği kullanılır.
4. doAction() yöntemi çağrılarak action olayı gönderilir.

package {
    import flash.display.Sprite;
    import flash.events.Event;

    public class EventDispatcherExample extends Sprite {

        public function EventDispatcherExample() {
            var dispatcher:CustomDispatcher = new CustomDispatcher();
            dispatcher.addEventListener(CustomDispatcher.ACTION, actionHandler);
            dispatcher.doAction();
        }

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

import flash.events.EventDispatcher;
import flash.events.Event;

class CustomDispatcher extends EventDispatcher {
    public static var ACTION:String = "action";

    public function doAction():void {
        dispatchEvent(new Event(CustomDispatcher.ACTION));
    }
}