MessageChannel - Adobe ActionScript® 3 (AS3 )

Pakiet	flash.system
Klasa	public final class MessageChannel
Dziedziczenie	MessageChannel EventDispatcher Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Klasa MessageChannel udostępnia mechanizm komunikacji procesu roboczego z innymi procesami roboczymi. Kanał komunikatów to mechanizm komunikacji jednokierunkowej. Wysyłający proces roboczy używa tego kanału do wysyłania obiektów do odbierającego procesu roboczego. Obiekt MessageChannel to jedyny sposób wysyłania komunikatów między procesami roboczymi, który wywołuje zdarzenie sygnalizujące procesowi odbierającemu, że jest dostępny komunikat. Inne mechanizmy udostępniania danych umożliwiają ustawienie wartości, ale nie zapewniają zdarzenia powiadamiającego o zmianie danych.

Każdy obiekt MessageChannel zawiera kolejkę obiektów komunikatów wysyłanych z nadającego do odbierającego procesu roboczego. Każde wywołanie metody send() powoduje dodanie obiektu do kolejki. Każde wywołanie metody receive() powoduje odebranie najstarszego obiektu komunikatu w kolejce.

Wystąpień klasy MessageChannel nie tworzy się przez bezpośrednie wywołanie konstruktora MessageChannel(). Aby utworzyć wystąpienie klasy MessageChannel, należy wywołać metodę createMessageChannel() obiektu Worker, który będzie wysyłać komunikaty w kanale, przekazując jako argument odbierający obiekt Worker.

Typowy obieg pracy związany z wysyłaniem komunikatów przy użyciu obiektu MessageChannel jest następujący:

Wywołanie metody createMessageChannel() nadającego procesu roboczego powoduje utworzenie kanału komunikatów.

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

Kanał komunikatów jest przekazywany do innego procesu roboczego przez wywołanie metody Worker.setSharedProperty() lub wysłanie za pośrednictwem istniejącego kanału komunikatów.
```
    receivingWorker.setSharedProperty("incomingChannel", sendChannel);
```

Kod w odbierającym procesie roboczym rejestruje detektor zdarzeń channelMessage dla obiektu MessageChannel.

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

Kod w wysyłającym procesie roboczym wysyła komunikat, wywołując metodę send().
```
    // In the sending worker swf
    sendChannel.send("This is a message");
```

Środowisko wykonawcze wywołuje moduł obsługi zdarzeń w kodzie odbierającego procesu roboczego, wskazując, że komunikat został wysłany.

    // 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
    }

Kod w odbierającym procesie roboczym wywołuje metodę receive(), aby pobrać komunikat. Obiekt zwrócony przez metodę receive() ma taki sam typ danych jak obiekt przekazany do metody send().
```
    var message:String = incomingChannel.receive() as String;
```

Poza przedstawionym powyżej asynchronicznym obiegiem pracy można zastosować alternatywny obieg pracy z metodą receive(), który umożliwia wstrzymanie kodu w odbierającym procesie roboczym do momentu wysłania komunikatu. Więcej informacji można znaleźć w opisie metody receive().

Klasa MessageChannel udostępnia jeden ze specjalnych typów obiektów, które są współużytkowane przez procesy robocze, a nie kopiowane między nimi. W przypadku przekazania kanału komunikatów z procesu roboczego do innego procesu roboczego przez wywołanie metody setSharedProperty() obiektu Worker lub użycie obiektu MessageChannel oba procesy robocze zawierają odniesienia do tego samego obiektu MessageChannel w pamięci środowiska wykonawczego.

Powiązane elementy interfejsu API

Klasa Worker
Metoda Worker.createMessageChannel()

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		messageAvailable : Boolean [tylko do odczytu] Wskazuje, czy wewnętrzna kolejka komunikatów obiektu MessageChannel zawiera co najmniej jeden komunikat od wysyłającego procesu roboczego.	MessageChannel
		state : String [tylko do odczytu] Wskazuje bieżący stan obiektu MessageChannel (otwarty, zamykanie lub zamknięty).	MessageChannel

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [przesłanianie] Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.	MessageChannel
		close():void Nakazuje zamknięcie bieżącego obiektu MessageChannel po otrzymaniu wszystkich komunikatów.	MessageChannel
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		receive(blockUntilReceived:Boolean = false):* Pobiera pojedynczy obiekt komunikatu z kolejki komunikatów wysłanych za pośrednictwem tego kanału komunikatów.	MessageChannel
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void [przesłanianie] Usuwa detektor z obiektu EventDispatcher.	MessageChannel
		send(arg:*, queueLimit:int = -1):void Wysyła obiekt z wysyłającego procesu roboczego, dodając obiekt do kolejki komunikatów dla odbierającego procesu roboczego.	MessageChannel
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String [przesłanianie] Zwraca ciąg reprezentujący określony obiekt.	MessageChannel
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
channelMessage	Wywoływana za każdym razem, gdy wysyłający proces roboczy wywołuje metodę send() danego obiektu MessageChannel, co wskazuje, że w kolejce wystąpienia klasy MessageChannel dostępny jest nowy obiekt komunikatu.	MessageChannel
channelState	Wywoływana, gdy zmienia się wartość właściwości state kanału komunikatów.	MessageChannel
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher

Szczegół właściwości

messageAvailable

właściwość

messageAvailable:Boolean [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Wskazuje, czy wewnętrzna kolejka komunikatów obiektu MessageChannel zawiera co najmniej jeden komunikat od wysyłającego procesu roboczego.

Implementacja
public function get messageAvailable():Boolean

state

właściwość

state:String [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Wskazuje bieżący stan obiektu MessageChannel (otwarty, zamykanie lub zamknięty). Możliwe wartości dla tej właściwości są zdefiniowane w klasie MessageChannelState.

Implementacja
public function get state():String

Powiązane elementy interfejsu API

Klasa MessageChannelState

Szczegół metody

addEventListener

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Rejestruje obiekt detektora zdarzenia w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. We wszystkich węzłach listy wyświetlania można rejestrować detektory zdarzeń reagujące na zdarzenia konkretnego typu, znajdujące się w określonej fazie i mające określony priorytet.

Po pomyślnym zarejestrowaniu detektora zdarzeń nie można zmienić jego priorytetu poprzez dodatkowe wywołania metody addEventListener(). Aby zmienić priorytet detektora, należy najpierw wywołać metodę removeListener(). Następnie można ponownie zarejestrować detektor z nowym poziomem priorytetu.

Należy pamiętać, że po zarejestrowaniu detektora późniejsze wywołania metody addEventListener() z różnymi wartościami type albo useCapture powodują rejestrowanie odrębnych detektorów. Na przykład detektor zarejestrowany z parametrem useCapture ustawionym na true wykrywa tylko zdarzenia w fazie przechwytywania. Po ponownym wywołaniu metody addEventListener() z tym samym obiektem detektora, ale z parametrem useCapture ustawionym na false będą istniały dwa odrębne detektory: jeden wykrywający zdarzenia w fazie przechwytywania, a drugi wykrywający zdarzenia w fazach miejsca docelowego i propagacji.

Nie można zarejestrować detektora zdarzeń, który wykrywałby tylko zdarzenia w fazie miejsca docelowego lub tylko zdarzenia w fazie propagacji. Te fazy są sprzężone podczas rejestracji, ponieważ propagacja zachodzi tylko w przodkach węzła miejsca docelowego.

Gdy detektor zdarzeń przestanie być potrzebny, należy go usunąć, wywołując metodę removeEventListener(); w przeciwnym razie mogą wystąpić problemy w zarządzaniu pamięcią. Detektory zdarzeń nie są automatycznie usuwane z pamięci, ponieważ proces czyszczenia pamięci nie usuwa detektora, pod warunkiem że istnieje obiekt wywołujący (o ile dla parametru useWeakReference ustawiona jest wartość true).

Skopiowanie instancji klasy EventDispatcher nie powoduje skopiowania detektorów zdarzeń dołączonych do tej instancji. (Jeśli utworzono nowy węzeł, dla którego potrzebny jest detektor zdarzeń, należy dołączyć detektor po utworzeniu węzła). Jednak przeniesienie instancji klasy EventDispatcher powoduje również przeniesienia dołączonych do niej detektorów zdarzeń

Jeśli detektor zdarzeń jest rejestrowany w węźle w momencie, gdy ten węzeł przetwarza zdarzenie, detektor nie zostanie wywołany w bieżącej fazie, ale może być wywołany w późniejszej fazie przepływu zdarzeń, np. w fazie propagacji.

Jeśli detektor zdarzeń zostanie usunięty z węzła w momencie, gdy ten węzeł przetwarza zdarzenie, zostanie wywołany przez bieżące operacje. Raz usunięty detektor zdarzeń nie jest nigdy ponownie wywoływany (chyba że zostanie ponownie zarejestrowany na potrzeby dalszego etapu wykonania programu).

Parametry

	`type:String` — Typ zdarzenia.

	`listener:Function` — Funkcja detektora, który przetwarza zdarzenie. Ta funkcja musi przyjmować obiekt Event jako swój jedyny parametr i nie może zwracać żadnych wyników, tak jak ilustruje to poniższy przykład: function(evt:Event):void Funkcja może mieć dowolną nazwę.

	`useCapture:Boolean` (default = `false`) — Określa, czy detektor działa w fazie przechwytywania, czy w fazach miejsca docelowego i propagacji. Jeżeli parametr `useCapture` jest ustawiony na `true`, wówczas detektor przetwarza zdarzenie tylko w trakcie fazy przechwytywania, a nie w trakcie fazy miejsca docelowego i propagacji. Jeżeli parametr `useCapture` ma wartość `false`, wówczas detektor przetwarza zdarzenie tylko w trakcie fazy miejsca docelowego i propagacji. W celu wykrywania zdarzenia we wszystkich trzech fazach należy wywołać metodę `addEventListener` dwa razy — raz z parametrem `useCapture` ustawionym na `true`, a następnie ponownie, z parametrem `useCapture` ustawionym na `false`.

	`priority:int` (default = `0`) — Poziom priorytetu detektora zdarzeń. Priorytet ma postać 32-bitowej liczby całkowitej ze znakiem. Im wyższa jest liczba, tym wyższy priorytet. Wszystkie detektory z priorytetem n są przetwarzane przed detektorami z priorytetem n-1. Jeżeli dwa lub większa liczba detektorów ma ten sam priorytet, będą one przetwarzane w kolejności, w jakiej zostały dodane. Priorytet domyślny to 0.

	`useWeakReference:Boolean` (default = `false`) — Określa, czy odwołanie do detektora jest mocne, czy słabe. Odwołanie mocne (domyślnie) zapobiega usunięciu detektora przy okazji porządkowania pamięci. Odwołanie słabe temu nie zapobiega. Funkcje składowe na poziomie klasy nie podlegają porządkowaniu pamięci, zatem można ustawić właściwość `useWeakReference` na wartość `true` dla funkcji składowych na poziomie klasy, nie narażając ich na usunięcie. Jeżeli właściwość `useWeakReference` zostanie ustawiona na wartość `true` dla detektora, który jest zagnieżdżoną funkcją wewnętrzną, wówczas funkcja będzie usuwana w procesie porządkowania pamięci i przestanie być trwała. W przypadku tworzenia odwołań do funkcji wewnętrznej (zapisania jej w innej zmiennej) nie będzie ona usuwana w procesie porządkowania pamięci i pozostanie trwała.

close

()

metoda

public function close():void

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Nakazuje zamknięcie bieżącego obiektu MessageChannel po otrzymaniu wszystkich komunikatów.

Po wywołaniu tej metody nie można już wywoływać metody send() w celu dodawania komunikatów do kolejki. Wywołanie metody send() nie powiedzie się i zostanie zwrócona wartość false.

Ponadto metodę receive() można wywoływać tylko w celu odbierania komunikatów oczekujących w kolejce. Jeżeli kolejka jest pusta, wywołanie metody receive() zwróci wartość null.

Zdarzenia

channelState:Event — Wywoływana po wywołaniu metody close() (która ustawia właściwość state na wartość MessageChannelState.CLOSING). Ponownie wywoływana, gdy wszystkie komunikaty zostały odebrane, a właściwość state jest ustawiona na wartość MessageChannelState.CLOSED.

receive

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Pobiera pojedynczy obiekt komunikatu z kolejki komunikatów wysłanych za pośrednictwem tego kanału komunikatów.

Za każdym razem, gdy kod wysyłającego procesu roboczego wywołuje metodę send() obiektu MessageChannel, do wewnętrznej kolejki w kanale komunikatów dodawany jest pojedynczy obiekt. Obiekty te są gromadzone w kolejce do momentu usunięcia ich pojedynczo przez wywołanie metody receive() w odbierającym procesie roboczym. Obiekty komunikatów są odbierane w kolejności wysyłania.

Aby sprawdzić, czy kolejka zawiera obiekt komunikatu do odebrania, należy użyć właściwości messageAvailable.

W standardowych przypadkach obiekt przekazany do metody send() jest serializowany w formacie AMF3. Gdy obiekt zostaje usunięty z kolejki przez wywołanie metody receive(), jest deserializowany do obiektu ActionScript (kopii oryginalnego obiektu) w odbierającym procesie roboczym, a proces roboczy otrzymuje odniesienie do tej kopii. Określone typy obiektów są współużytkowane przez procesy robocze, a nie kopiowane. W takiej sytuacji obiekt dostarczany do procesu roboczego jest odniesieniem do obiektu współużytkowanego, a nie nową kopią obiektu. Więcej informacji na ten temat można znaleźć w opisie metody send().

Zachowanie metody zmienia się, gdy kolejka komunikatów jest pusta, a przekazany parametr blockUntilReceived ma wartość true. W takim przypadku proces roboczy wstrzymuje wątek wykonywania przy wywołaniu metody receive() i nie wykonuje dodatkowego kodu. Po wywołaniu przez wysyłający proces roboczy metody send() wywołanie metody receive() kończy działanie odebraniem komunikatu. Następnie proces roboczy wznawia wykonywanie kodu w następnym wierszu po wywołaniu metody receive().

Parametry

blockUntilReceived:Boolean (default = false) — Wskazuje, czy wątek wykonawczy procesu roboczego powinien otrzymać obiekt komunikatu, a następnie kontynuować wykonywanie (false), czy powinien zostać wstrzymany przy wywołaniu metody receive() i zaczekać na wysłanie komunikatu, jeśli kolejka jest pusta (true).

Zwraca

* — Kopia obiektu przekazana do metody send() przez wysyłający proces roboczy. Jeśli obiekt należy do jednego z typów specjalnych współużytkowanych przez procesy robocze, zwracana wartość jest odniesieniem do obiektu współużytkowanego, a nie do kopii. Jeśli w kolejce nie ma dostępnych komunikatów, metoda zwraca wartość null.

Zgłasza

	`IOError` — Jeśli kanał jest zamknięty w momencie wywołania metody lub argument `blockUntilReceived` powoduje wstrzymanie wykonywania, a kanał następnie zostaje zamknięty przez inny proces roboczy.

	`ArgumentError` — Jeśli kod wywołujący nie znajduje się w odbierającym procesie roboczym.

	`ScriptTimeoutError` — Jeśli metoda jest wywoływana z kodu w pierwotnym procesie roboczym w programie Flash Player, zaś argument `blockUntilReceived` powoduje wstrzymanie działania procesu roboczego na czas dłuższy niż limit czasu skryptu (domyślnie 15 sekund).

Powiązane elementy interfejsu API

Metoda send()
Właściwość messageAvailable

removeEventListener

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Usuwa detektor z obiektu EventDispatcher. Jeśli w obiekcie EventDispatcher nie ma zarejestrowanego zgodnego detektora zdarzeń, wywołanie tej metody nie odnosi żadnego skutku.

Parametry

	`type:String` — Typ zdarzenia.

	`listener:Function` — Obiekt detektora przeznaczony do usunięcia.

	`useCapture:Boolean` (default = `false`) — Określa, czy detektor był zarejestrowany dla fazy przechwytywania, czy dla faz miejsca docelowego i propagacji. Jeżeli detektor był zarejestrowany zarówno dla fazy przechwytywania, jak i dla fazy miejsca docelowego i propagacji, konieczne są dwa wywołania metody `removeEventListener()`: jedno wywołanie z parametrem `useCapture` ustawionym na `true`, a następne wywołanie z parametrem `useCapture` ustawionym na `false`.

send

()

metoda

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

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Wysyła obiekt z wysyłającego procesu roboczego, dodając obiekt do kolejki komunikatów dla odbierającego procesu roboczego.

Do parametru arg można przekazać prawie dowolny obiekt. Poza wyjątkami wskazanymi poniżej obiekty przekazywane do parametru arg nie są przekazywane przez odniesienie. Zmiany wprowadzone w obiekcie w jednym z procesów roboczych po wywołaniu metody send() nie są przenoszone do innego procesu roboczego. Obiekt jest kopiowany przez serializację do formatu AMF3, a następnie deserializację w postaci nowego obiektu w odbierającym procesie roboczym po wywołaniu metody receive(). Z tego powodu obiektów, które nie umożliwiają serializacji w formacie AMF3 (w tym obiektów wyświetlanych), nie można przekazać do parametru arg. W celu prawidłowego przekazania obiektu klasy własnej definicja tej klasy musi zostać zrejestrowana przy użyciu funkcji flash.net.registerClassAlias() lub metadanych [RemoteClass]. W przypadku obu tych technik należy zastosować taki sam alias dla wersji klas obu procesów roboczych.

Istnieje pięć typów obiektów, które są wyjątkami od reguły dotyczącej braku współużytkowania obiektów między procesami roboczymi:

Worker
MessageChannel
Współużytkowany obiekt ByteArray (obiekt ByteArray, którego właściwość shareable ma wartość true)
Mutex
Condition

W przypadku przekazania jednego z tych obiektów do parametru arg każdy proces roboczy zawiera odniesienie do tego samego obiektu podstawowego. Zmiany wprowadzone w wystąpieniu w jednym procesie roboczym są natychmiast dostępne w innych procesach. Ponadto jeżeli to samo wystąpienie tych obiektów zostanie wielokrotnie przekazane przy użyciu metody send(), środowisko wykonawcze nie utworzy nowej kopii obiektu w odbiorczym procesie roboczym. Zamiast tego zostanie ponownie użyte to samo odniesienie, co pozwala ograniczyć użycie pamięci systemowej.

Domyślnie ta metoda dodaje obiekt do kolejki i natychmiast powraca do wykonywania kodu od następnego wiersza. Aby zapobiec przekroczeniu określonego rozmiaru kolejki, można za pomocą parametru queueLimit określić maksymalną liczbę elementów dozwolonych w kolejce. Jeśli podczas wywołania funkcji send() liczba elementów w kolejce będzie większa niż określony limit, proces roboczy wstrzyma wątek wykonywania przy wywołaniu funkcji send(). Gdy odbierający proces roboczy wywoła metodę receive() wystarczającą liczbę razy, aby ograniczyć rozmiar kolejki do określonego limitu, wywołanie metody send() zostanie zakończone. Następnie proces roboczy wznowi wykonywanie kodu w następnym wierszu.

Parametry

	`arg:*` — Obiekt do dodania do kolejki komunikatów.

	`queueLimit:int` (default = `-1`) — Maksymalna liczba obiektów komunikatów, które może zawierać kolejka komunikatów. Jeśli kolejka zawiera większą liczbę obiektów niż dopuszczalny limit, wykonywanie wysyłającego procesu roboczego ulega wstrzymaniu do momentu odebrania komunikatów i zmniejszenia rozmiaru kolejki poniżej limitu.

Zdarzenia

channelMessage:Event — Wywoływana w celu powiadomienia odbierającego procesu roboczego, że obiekt komunikatu jest dostępny w kolejce.

Zgłasza

	`IOError` — Jeśli kanał jest zamknięty w momencie wywołania metody lub argument `queueLimit` powoduje wstrzymanie wykonywania, a kanał następnie zostaje zamknięty przez inny proces roboczy.

	`ArgumentError` — Jeśli kod wywołujący nie znajduje się w wysyłającym procesie roboczym.

	`ScriptTimeoutError` — Jeśli metoda jest wywoływana z kodu w pierwotnym procesie roboczym w programie Flash Player, zaś argument `queueLimit` powoduje wstrzymanie działania procesu roboczego na czas dłuższy niż limit czasu skryptu (domyślnie 15 sekund).

Powiązane elementy interfejsu API

Metoda receive()
Klasa Worker
Właściwość ByteArray.shareable
Klasa Mutex
Klasa Condition

toString

()

metoda

override public function toString():String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Zwraca ciąg znaków reprezentujący określony obiekt.

Uwaga: Metody klasy Object są tworzone dynamicznie w prototypie klasy Object. Do ponownego zdefiniowania tej metody w podklasie Object, nie należy używać słowa kluczowego override. Na przykład zamiast nadpisania klasy podstawowej dla podklasy Object implementowana jest funkcja function toString():String.

Zwraca

String — Ciąg znaków reprezentujący obiekt.

Szczegół zdarzenia

channelMessage

Zdarzenie

Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.CHANNEL_MESSAGE

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Wywoływana za każdym razem, gdy wysyłający proces roboczy wywołuje metodę send() danego obiektu MessageChannel, co wskazuje, że w kolejce wystąpienia klasy MessageChannel dostępny jest nowy obiekt komunikatu.

Stała Event.CHANNEL_MESSAGE definiuje wartość właściwości type obiektu zdarzenia channelMessage.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał to zdarzenie.

channelState

Zdarzenie

Typ obiektu zdarzenia: flash.events.Event
właściwość Event.type = flash.events.Event.CHANNEL_STATE

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 11.4, AIR 3.4

Wywoływana, gdy zmienia się wartość właściwości state kanału komunikatów.

Stała Event.CHANNEL_STATE definiuje wartość właściwości type obiektu zdarzenia channelState.

To zdarzenie ma następujące właściwości:

Właściwość	Wartość
`bubbles`	`false`
`cancelable`	`false`; nie ma domyślnego zachowania, które można byłoby anulować.
`currentTarget`	Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń.
`target`	Obiekt, który wywołał to zdarzenie.

Informacje prawne | Zasady prywatności online

MessageChannel - AS3

Pakietyx

Elementy językowe

Dodatki

Pakiet flash.system

messageAvailable

state

addEventListener

close

receive

removeEventListener

send

toString

channelMessage

channelState