MessageChannel - Adobe ActionScript® 3 (AS3 ) API Başvurusu

Paket	flash.system
Sınıf	public final class MessageChannel
Miras Alma	MessageChannel EventDispatcher Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

MessageChannel sınıfı, bir worker (işçi) öğesinin başka bir worker (işçi) ile iletişim kurması için bir mekanizma sağlar. Mesaj kanalı, tek yönlü bir iletişim kanalıdır. Mesaj kanalının gönderen worker (işçi) öğesi, alıcı worker (işçi) öğesine nesneler göndermek için mesaj kanalını kullanır. MessageChannel nesnesi, mesajın kullanılabilir olduğunu alıcıya bildiren bir olay gönderen mesajı worker (işçi) öğeleri arasında göndermek için tek yoldur. Veri paylaşımına yönelik diğer mekanizmalar bir değerin ayarlanmasına olanak sağlar ancak değiştirilen verileri size bildirmek için bir olay sağlamaz.

Her MessageChannel nesnesi, gönderen worker (işçi) öğesinden alıcı worker (işçi) öğesine gönderilen mesaj nesnelerinin bir kuyruğunu içerir. send() öğesine yapılan her çağrıda, kuyruğa bir nesne eklenir. receive() öğesine yapılan her çağrıda, kuyruktan en eski mesaj nesnesi alınır.

MessageChannel() yapıcısını çağırarak doğrudan MessageChannel örnekleri oluşturmazsınız. Bir MessageChannel örneği oluşturmak için, alıcı Worker (İşçi) öğesini argüman olarak ileterek kanalda mesajlar gönderecek Worker nesnesinin createMessageChannel() yöntemini çağırın.

MessageChannel nesnesi ile mesaj göndermeye ilişkin tipik iş akışı şu şekildedir:

Mesaj kanalı oluşturmak için gönderen worker (işçi) öğesinin createMessageChannel() yöntemini çağırın

    // In the sending worker swf
    var sendChannel:MessageChannel;
    sendChannel = Worker.current.createMessageChannel(receivingWorker);

Worker.setSharedProperty() yöntemini çağırarak veya varolan mesaj kanalı aracılığıyla göndererek mesaj kanalını diğer worker (işçi) öğesine iletin
```
    receivingWorker.setSharedProperty("incomingChannel", sendChannel);
```

Alıcı worker (işçi) öğesindeki kod, channelMessage olayı için MessageChannel nesnesi ile bir dinleyiciyi kaydeder

    // In the receiving worker swf
    var incomingChannel:MessageChannel;
    incomingChannel = Worker.current.getSharedProperty("incomingChannel");
    incomingChannel.addEventListener(Event.CHANNEL_MESSAGE, handleIncomingMessage);

Gönderen worker (işçi) öğesindeki kod, send() yöntemini çağırarak bir mesaj gönderir
```
    // In the sending worker swf
    sendChannel.send("This is a message");
```

Çalışma zamanı, alıcı worker (işçi) kodunda olay işleyiciyi çağırarak bir mesajın gönderildiğini belirtir

    // In the receiving worker swf
    // This method is called when the message channel gets a message
    private function handleIncomingMessage(event:Event):void
    {
        // Do something with the message, as shown in the next code listing
    }

Alıcı worker (işçi) öğesindeki kod, mesajı almak için receive() yöntemini çağırır. receive() yöntemi tarafından döndürülen nesne, send() yöntemine iletilen nesne ile aynı veri türüne sahiptir.
```
    var message:String = incomingChannel.receive() as String;
```

Yukarıda açıklanan senkronize olmayan iş akışına ek olarak, alıcı worker (işçi) öğesinde kodu duraklatmak için receive() yöntemi ile alternatif bir iş akışı kullanabilir ve bir mesaj gönderilinceye kadar bekleyebilirsiniz. Daha fazla bilgi için receive() yönteminin açıklamasına bakın.

MessageChannel sınıfı, worker (işçi) öğeleri arasında kopyalanan değil, paylaşılan özel nesne türlerinden biridir. Worker nesnesinin setSharedProperty() yöntemini çağırarak veya bir MessageChannel nesnesini kullanarak bir worker (işçi) öğesinden başka bir worker (işçi) öğesine bir mesaj kanalı ilettiğinizde, her iki worker (işçi) öğesinin de çalışma zamanının belleğinde aynı MessageChannel nesnesine referansı vardır.

İlgili API Öğeleri

Worker sınıfı
Worker.createMessageChannel() yöntemi

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Ö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
		messageAvailable : Boolean [salt okunur] MessageChannel öğesinin, dahili mesaj kuyruğunda gönderen worker (işçi) öğesinden bir veya daha fazla mesaja sahip olup olmadığını belirtir.	MessageChannel
		state : String [salt okunur] MessageChannel nesnesinin geçerli durumunu belirtir (açık, kapanıyor veya kapalı).	MessageChannel

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [geçersiz kıl] EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder.	MessageChannel
		close():void Geçerli MessageChannel öğesine, tüm mesajlar alındıktan sonra kapatılmasını söyler.	MessageChannel
		dispatchEvent(event:Event):Boolean Olay akışına bir olay gönderir.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.	EventDispatcher
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		receive(blockUntilReceived:Boolean = false):* Bu mesaj kanalı aracılığıyla gönderilen mesajların kuyruğundan tek bir mesaj nesnesini alır.	MessageChannel
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void [geçersiz kıl] EventDispatcher nesnesinden bir dinleyiciyi kaldırır.	MessageChannel
		send(arg:*, queueLimit:int = -1):void Gönderen worker (işçi) öğesinden bir nesne göndererek bu nesneyi alıcı worker (işçi) için mesaj kuyruğuna ekler.	MessageChannel
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String [geçersiz kıl] Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	MessageChannel
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object
		willTrigger(type:String):Boolean 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

Olaylar

Olaylarla ilgili daha fazla bilgi için tıklatın

Miras Alınan Olayları Gizle

Miras Alınan Olayları Göster

	Özet	Tanımlayan:
activate	[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.	EventDispatcher
channelMessage	Gönderen worker (işçi) öğesi bu MessageChannel nesnesinin send() yöntemini her çağırdığında gönderilir ve MessageChannel örneğinin kuyruğunda yeni bir mesaj nesnesinin kullanılabilir olduğunu belirtir.	MessageChannel
channelState	Mesaj kanalının state özelliğinin değeri değiştiğinde gönderilir.	MessageChannel
deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher

Özellik Ayrıntısı

messageAvailable

özellik

messageAvailable:Boolean [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

MessageChannel öğesinin, dahili mesaj kuyruğunda gönderen worker (işçi) öğesinden bir veya daha fazla mesaja sahip olup olmadığını belirtir.

Uygulama
public function get messageAvailable():Boolean

state

özellik

state:String [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

MessageChannel nesnesinin geçerli durumunu belirtir (açık, kapanıyor veya kapalı). Bu özellik için olası değerler, MessageChannelState sınıfında sabitler olarak tanımlanır.

Uygulama
public function get state():String

İlgili API Öğeleri

MessageChannelState sınıfı

Yöntem Ayrıntısı

addEventListener

()

yöntem

override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

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

	`type:String` — Olay türü.

	`listener:Function` — Olayı işleyen dinleyici işlevi. Bu işlev, bu örnekte gösterildiği gibi, Event nesnesini tek parametresi olarak kabul etmeli ve hiçbir öğe döndürmemelidir: function(evt:Event):void İşleve herhangi bir ad verilebilir.

	`useCapture:Boolean` (default = `false`) — Dinleyicinin yakalama aşamasında mı, yoksa hedef ve köpürme aşamalarında mı çalıştığını belirler. `useCapture`, `true` olarak ayarlanırsa dinleyici, olayı hedef veya köpürme aşamasında değil de yalnızca yakalama aşamasında işler. `useCapture` `false` değerindeyse dinleyici, olayı yalnızca hedef veya köpürme aşamasında işler. Olayı üç aşamada da dinlemek için `addEventListener` öğesini iki kez, biri `useCapture` `true` değerine ayarlanmış olarak, diğeri de `useCapture` `false` değerine ayarlanmış olarak çağırın.

	`priority:int` (default = `0`) — Olay dinleyicisinin öncelik düzeyi. Öncelik, işaretli 32 bit tam sayı tarafından atanır. Sayı ne kadar yüksekse, öncelik de o kadar yüksek olur. n önceliğine sahip tüm dinleyiciler, n-1 önceliğine sahip dinleyicilerden önce işlenir. İki veya daha fazla dinleyici aynı önceliği paylaşırsa, eklendikleri sıraya göre işlenirler. Varsayılan öncelik 0'dır.

	`useWeakReference:Boolean` (default = `false`) — Dinleyici başvurusunun güçlü mü, yoksa zayıf mı olduğunu belirler. Güçlü bir başvuru (varsayılan), dinleyicinizin çöp toplama işlemine tabi tutulmasını önler. Zayıf bir başvuru, bu işlevi yapmaz. Sınıf düzeyi üye işlevleri, çöp toplama işlemine tabi değildir. Böylece onları çöp toplama işlemine tabi tutmadan, sınıf düzeyi üye işlevleri için `useWeakReference` öğesini `true` değerine ayarlayabilirsiniz. Yuvalanmış iç işlev olan bir dinleyici için `useWeakReference` öğesini `true` olarak ayarladığınızda, işlev çöp toplama işlemine tabi tutulur ve kalıcı olmaz. İç işleve başvuru oluşturursanız (başka bir değişkende kaydederseniz), çöp toplama işlemine tabi tutulmaz ve kalıcı olarak kalır.

close

()

yöntem

public function close():void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

Geçerli MessageChannel öğesine, tüm mesajlar alındıktan sonra kapatılmasını söyler.

Bu yöntemi çağırdıktan sonra kuyruğa mesajlar eklemek için artık send() yöntemini çağıramazsınız. send() çağrısı başarısız olur ve false değerini döndürür.

Yalnızca önceden kuyrukta bekleyen mesajları almak için de receive() yöntemini çağırabilirsiniz. Kuyruk boşsa, receive() çağrısı null değerini döndürür.

Olaylar

channelState:Event — close() yöntemi çağrıldığında (bu, state özelliğini MessageChannelState.CLOSING olarak ayarlar) gönderilir. Tüm mesajlar alındığında ve state özelliği MessageChannelState.CLOSED olarak ayarlandığında yeniden gönderilir.

receive

()

yöntem

public function receive(blockUntilReceived:Boolean = false):*

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

Bu mesaj kanalı aracılığıyla gönderilen mesajların kuyruğundan tek bir mesaj nesnesini alır.

Gönderen worker (işçi) öğesinin kodu, MessageChannel nesnesinin send() yöntemini her çağırdığında, mesaj kanalının dahili mesaj kuyruğuna tek bir nesne eklenir. Bu nesneler, receive() yöntemini çağıran alıcı worker (işçi) tarafından teker teker kaldırılıncaya kadar kuyrukta istiflenir. Mesaj nesneleri, gönderildikleri sırayla alınır.

Kuyruğun alınacak bir mesaj nesnesi içerip içermediğini kontrol etmek için messageAvailable özelliğini kullanın.

Standart durumda, send() öğesine iletilen nesne AMF3 biçiminde serileştirilir. receive() çağrısı tarafından kuyruktan kaldırıldığında, alıcı worker (işçi) öğesinde bir ActionScript nesnesine (orijinal nesnenin bir kopyası) bunun serileştirilmesi kaldırılır ve worker (işçi) o kopyanın bir referansını alır. Belirli türde nesneler kopyalanmaz, ancak worker (işçi) öğeleri arasında paylaşılır. Bu durumda, alıcı worker (işçi) öğesinin aldığı nesne, nesnenin yeni bir kopyası değil, paylaşılan nesnenin bir referansıdır. Bu durumla ilgili daha fazla bilgi için send() yönteminin açıklamasına bakın.

Mesaj kuyruğu boşsa ve blockUntilReceived parametresi için true değerini iletirseniz, yöntemin davranışı değişir. Bu durumda worker (işçi), receive() çağrısında yürütme iş parçacığını duraklatır ve daha fazla kod yürütmez. Gönderen worker (işçi), send() öğesini çağırdıktan sonra receive() çağrısı mesajı alarak tamamlanır. Worker (işçi), receive çağrısının ardından bir sonraki kod satırında kod yürütmeyi sürdürür.

Parametreler

blockUntilReceived:Boolean (default = false) — worker (işçi) öğesinin yürütme iş parçacığının bir mesaj nesnesi alıp yürütmeye devam edeceğini (false) veya receive() çağrısında duraklayıp kuyruk boş olduğunda bir mesajın gönderilmesini bekleyeceğini (true) belirtir

Döndürür

* — worker (işçi) gönderilerek send() yöntemine iletilen nesnenin bir kopyası. Nesne, worker (işçi) öğeleri arasında paylaşılan özel türlerden biriyse, döndürülen değer, paylaşılan nesnenin kopyası değil, paylaşılan nesnenin bir referansıdır. Kuyrukta kullanılabilir bir mesaj yoksa, yöntem null değerini döndürür.

Atar

	`IOError` — yöntem çağrıldığı anda kanal kapatılırsa veya `blockUntilReceived` argümanı, yürütmenin duraklatılmasıyla sonuçlanırsa ve daha sonra kanal başka bir worker (işçi) tarafından kapatılırsa.

	`ArgumentError` — arama kodu, alıcı worker (işçi) öğesinde değilse

	`ScriptTimeoutError` — yöntem, Flash Player'da ilkel worker (işçi) öğesindeki koddan çağrılırsa ve `blockUntilReceived` argümanı, worker (işçi) öğesinin komut dosyası zaman aşımı sınırından (varsayılan olarak 15 saniye) uzun duraklamasına neden olursa

İlgili API Öğeleri

send() yöntemi
messageAvailable özelliği

removeEventListener

()

yöntem

override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

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

	`type:String` — Olay türü.

	`listener:Function` — Kaldırılacak dinleyici nesnesi.

	`useCapture:Boolean` (default = `false`) — Dinleyicinin yakalama aşaması için mi yoksa hedef ve köpürme aşamaları için mi kaydedildiğini belirtir. Dinleyici, hem yakalama aşaması hem de hedef ve köpürme aşamaları için kaydedildiyse, `removeEventListener()` öğesine yapılan iki çağrı, ikisini de kaldırmak için gereklidir. `useCapture()` öğesine sahip çağrılardan biri `true`, `useCapture()` öğesine sahip olan diğeri ise `false` olarak ayarlanmıştır.

send

()

yöntem

public function send(arg:*, queueLimit:int = -1):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

Gönderen worker (işçi) öğesinden bir nesne göndererek bu nesneyi alıcı worker (işçi) için mesaj kuyruğuna ekler.

arg parametresine iletilen nesne neredeyse herhangi bir nesne olabilir. Aşağıda belirtilen istisnalar dışında, arg parametresine iletilen herhangi bir nesne, referans tarafından iletilmez. send() çağrıldıktan sonra bir worker (işçi) öğesindeki nesneye yapılan herhangi bir değişiklik, diğer worker (işçi) öğesine taşınmaz. receive() çağrıldığında nesne AMF3 biçimine serileştirilerek ve alıcı worker (işçi) öğesindeki yeni bir nesneye serileştirilmesi kaldırılarak kopyalanır. Bu nedenle, görüntüleme nesneleri de dahil olmak üzere, AMF3 biçiminde serileştirilemeyen herhangi bir nesne, arg parametresine iletilemez. Özel sınıfın düzgün şekilde iletilmesi için, flash.net.registerClassAlias() işlevi veya [RemoteClass] meta verisi kullanılarak sınıf tanımının kaydedilmesi gerekir. Bu tekniklerden herhangi biriyle, her iki worker (işçi) öğesinin sınıf sürümü için aynı diğer ad kullanılmalıdır.

Bu kural için, nesnelerin worker (işçi) öğeleri arasında paylaşılmadığı istisna niteliğinde beş tür nesne vardır:

Worker
MessageChannel
paylaşılabilir ByteArray (shareable özelliği true olarak ayarlanmış bir ByteArray nesnesi
Mutex
Durum

Bu nesnelerin bir örneğini arg parametresine iletirseniz, her worker (işçi) öğesinin aynı temel nesneye bir referansı vardır. Bir worker (işçi) öğesindeki örnek üzerinde yapılan değişiklikler, diğer worker (işçi) öğelerinde hemen kullanılabilir olur. Ayrıca, send() yöntemini kullanarak bu nesnelerin aynı örneğini birden çok defa iletirseniz çalışma zamanı, alıcı worker (işçi) öğesinde nesnenin yeni bir kopyasını oluşturmaz. Bunun yerine, aynı referans yeniden kullanılır ve böylece sistem belleği kullanımı azaltılır.

Varsayılan olarak bu yöntem, nesneyi kuyruğa ekler ve hemen dönerek sonraki kod satırıyla yürütmeyi sürdürür. Kuyruğun belirli bir boyutun ötesinde büyümesini önlemek istiyorsanız, kuyrukta izin verilecek maksimum öğe sayısını belirtmek için queueLimit parametresini kullanabilirsiniz. send() yöntemini çağırdığınız anda kuyruktaki öğe sayısı belirttiğiniz sınırdan büyükse worker (işçi), send() çağrısında yürütme iş parçacığını duraklatır. Alıcı worker (işçi), kuyruk boyutu belirtilen kuyruk sınırından küçük olacak şekilde receive() yöntemini yeterli defa çağırdıktan sonra, send() çağrısı tamamlanır. Ardından worker (işçi), sonraki kod satırında yürütmeye devam eder.

Parametreler

	`arg:*` — mesaj kuyruğuna eklenecek nesne

	`queueLimit:int` (default = `-1`) — mesaj kuyruğunun içerebileceği maksimum mesaj sayısı. Kuyruk, sınırdan daha fazla nesne içeriyorsa, mesajlar alınıncaya ve kuyruk boyutu sınırın altına düşünceye kadar, gönderen worker (işçi) öğesi yürütmeyi duraklatır.

Olaylar

channelMessage:Event — alıcı worker (işçi) öğesine, kuyrukta bir mesaj nesnesinin kullanılabilir olduğunu bildirmek için gönderilir

Atar

	`IOError` — yöntem çağrıldığı anda kanal kapatılırsa veya `queueLimit` argümanı, yürütmenin duraklatılmasıyla sonuçlanırsa ve daha sonra kanal başka bir worker (işçi) tarafından kapatılırsa.

	`ArgumentError` — arama kodu, gönderen worker (işçi) öğesinde değilse

	`ScriptTimeoutError` — yöntem, Flash Player'da ilkel worker (işçi) öğesindeki koddan çağrılırsa ve `queueLimit` argümanı, worker (işçi) nesnesinin komut dosyası zaman aşımı sınırından (varsayılan olarak 15 saniye) uzun duraklamasına neden olursa

İlgili API Öğeleri

receive() yöntemi
Worker sınıfı
ByteArray.shareable özelliği
Mutex sınıfı
Condition sınıfı

toString

()

yöntem

override public function toString():String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

Belirtilen nesnenin dize olarak temsil edilen halini döndürür.

Not: Object sınıfı yöntemleri, Object prototipinde dinamik olarak oluşturulur. Bir Object alt sınıfında bu yöntemi yeniden tanımlamak için override anahtar kelimesini kullanmayın. Örneğin, Object sınıfının bir alt sınıfı, temel sınıfın geçersiz kılınmasını kullanmak yerine, function toString():String uygular.

Döndürür

String — Nesnenin dize olarak temsil edilen hali.

Olay Ayrıntısı

channelMessage

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.CHANNEL_MESSAGE

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

Gönderen worker (işçi) öğesi bu MessageChannel nesnesinin send() yöntemini her çağırdığında gönderilir ve MessageChannel örneğinin kuyruğunda yeni bir mesaj nesnesinin kullanılabilir olduğunu belirtir.

Event.CHANNEL_MESSAGE sabiti, bir channelMessage olay nesnesinin type özelliğinin 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`	Bu olayı gönderen nesne.

channelState

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.CHANNEL_STATE

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11.4, AIR 3.4

Mesaj kanalının state özelliğinin değeri değiştiğinde gönderilir.

Event.CHANNEL_STATE sabiti, bir channelState olay nesnesinin type özelliğinin 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`	Bu olayı gönderen nesne.

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

MessageChannel - AS3

Paketlerx

Dil Öğeleri

Ekler

Paket flash.system

messageAvailable

state

addEventListener

close

receive

removeEventListener

send

toString

channelMessage

channelState