Naslaggids voor Adobe ActionScript® 3.0 voor het Adobe® Flash®-platform
Startpagina  |  Lijst met pakketten en klassen verbergen |  Pakketten  |  Klassen  |  Nieuw  |  Index  |  Bijlagen  |  Waarom in het Engels?
Filters: AIR 30.0 en eerder, Flash Player 30.0 en eerder, Flash Lite 4
Flex 4.6 en eerder, Flash Pro CS6 en eerder
Filters verbergen
flash.system 

MessageChannel  - AS3

Pakkettenx

Hoofdniveau
adobe.utils
air.desktop
air.net
air.update
air.update.events
coldfusion.air
coldfusion.air.errors
coldfusion.air.events
coldfusion.service
coldfusion.service.events
coldfusion.service.mxml
com.adobe.acm.solutions.authoring.domain.extensions
com.adobe.acm.solutions.ccr.domain.extensions
com.adobe.consulting.pst.vo
com.adobe.dct.component
com.adobe.dct.component.datadictionary
com.adobe.dct.component.datadictionaryElement
com.adobe.dct.component.dataElementsPanel
com.adobe.dct.component.toolbars
com.adobe.dct.event
com.adobe.dct.exp
com.adobe.dct.model
com.adobe.dct.service
com.adobe.dct.service.provider
com.adobe.dct.transfer
com.adobe.dct.util
com.adobe.dct.view
com.adobe.ep.taskmanagement.domain
com.adobe.ep.taskmanagement.event
com.adobe.ep.taskmanagement.filter
com.adobe.ep.taskmanagement.services
com.adobe.ep.taskmanagement.util
com.adobe.ep.ux.attachmentlist.component
com.adobe.ep.ux.attachmentlist.domain
com.adobe.ep.ux.attachmentlist.domain.events
com.adobe.ep.ux.attachmentlist.domain.renderers
com.adobe.ep.ux.attachmentlist.skin
com.adobe.ep.ux.attachmentlist.skin.renderers
com.adobe.ep.ux.content.event
com.adobe.ep.ux.content.factory
com.adobe.ep.ux.content.handlers
com.adobe.ep.ux.content.managers
com.adobe.ep.ux.content.model.asset
com.adobe.ep.ux.content.model.preview
com.adobe.ep.ux.content.model.relation
com.adobe.ep.ux.content.model.search
com.adobe.ep.ux.content.model.toolbar
com.adobe.ep.ux.content.search
com.adobe.ep.ux.content.services
com.adobe.ep.ux.content.services.load
com.adobe.ep.ux.content.services.permissions
com.adobe.ep.ux.content.services.preview
com.adobe.ep.ux.content.services.providers
com.adobe.ep.ux.content.services.query
com.adobe.ep.ux.content.services.relationships
com.adobe.ep.ux.content.services.search.lccontent
com.adobe.ep.ux.content.services.version
com.adobe.ep.ux.content.view
com.adobe.ep.ux.content.view.components.activate
com.adobe.ep.ux.content.view.components.grid
com.adobe.ep.ux.content.view.components.grid.hover
com.adobe.ep.ux.content.view.components.grid.hover.component
com.adobe.ep.ux.content.view.components.grid.renderers
com.adobe.ep.ux.content.view.components.relationships
com.adobe.ep.ux.content.view.components.review
com.adobe.ep.ux.content.view.components.search.renderers
com.adobe.ep.ux.content.view.components.searchpod
com.adobe.ep.ux.content.view.components.toolbar
com.adobe.ep.ux.content.view.components.toolbar.controlRenderers
com.adobe.ep.ux.content.view.components.version
com.adobe.ep.ux.documentsubmit.component
com.adobe.ep.ux.documentsubmit.domain
com.adobe.ep.ux.documentsubmit.skin
com.adobe.ep.ux.taskaction.component
com.adobe.ep.ux.taskaction.domain
com.adobe.ep.ux.taskaction.domain.events
com.adobe.ep.ux.taskaction.skin
com.adobe.ep.ux.taskdetails.component
com.adobe.ep.ux.taskdetails.domain
com.adobe.ep.ux.taskdetails.skin
com.adobe.ep.ux.tasklist.component
com.adobe.ep.ux.tasklist.domain
com.adobe.ep.ux.tasklist.skin
com.adobe.ep.ux.webdocumentviewer.domain
com.adobe.exm.expression
com.adobe.exm.expression.error
com.adobe.exm.expression.event
com.adobe.exm.expression.impl
com.adobe.fiber.runtime.lib
com.adobe.fiber.services
com.adobe.fiber.services.wrapper
com.adobe.fiber.styles
com.adobe.fiber.util
com.adobe.fiber.valueobjects
com.adobe.gravity.binding
com.adobe.gravity.context
com.adobe.gravity.flex.bundleloader
com.adobe.gravity.flex.progress
com.adobe.gravity.flex.serviceloader
com.adobe.gravity.framework
com.adobe.gravity.init
com.adobe.gravity.service.bundleloader
com.adobe.gravity.service.logging
com.adobe.gravity.service.manifest
com.adobe.gravity.service.progress
com.adobe.gravity.tracker
com.adobe.gravity.ui
com.adobe.gravity.utility
com.adobe.gravity.utility.async
com.adobe.gravity.utility.error
com.adobe.gravity.utility.events
com.adobe.gravity.utility.factory
com.adobe.gravity.utility.flex.async
com.adobe.gravity.utility.logging
com.adobe.gravity.utility.message
com.adobe.gravity.utility.sequence
com.adobe.gravity.utility.url
com.adobe.guides.control
com.adobe.guides.domain
com.adobe.guides.i18n
com.adobe.guides.spark.components.skins
com.adobe.guides.spark.components.skins.mx
com.adobe.guides.spark.headers.components
com.adobe.guides.spark.headers.skins
com.adobe.guides.spark.layouts.components
com.adobe.guides.spark.layouts.skins
com.adobe.guides.spark.navigators.components
com.adobe.guides.spark.navigators.renderers
com.adobe.guides.spark.navigators.skins
com.adobe.guides.spark.util
com.adobe.guides.spark.wrappers.components
com.adobe.guides.spark.wrappers.skins
com.adobe.guides.submit
com.adobe.icc.dc.domain
com.adobe.icc.dc.domain.factory
com.adobe.icc.editors.events
com.adobe.icc.editors.handlers
com.adobe.icc.editors.managers
com.adobe.icc.editors.model
com.adobe.icc.editors.model.config
com.adobe.icc.editors.model.el
com.adobe.icc.editors.model.el.operands
com.adobe.icc.editors.model.el.operators
com.adobe.icc.enum
com.adobe.icc.external.dc
com.adobe.icc.obj
com.adobe.icc.services
com.adobe.icc.services.category
com.adobe.icc.services.config
com.adobe.icc.services.download
com.adobe.icc.services.export
com.adobe.icc.services.external
com.adobe.icc.services.formbridge
com.adobe.icc.services.fragmentlayout
com.adobe.icc.services.layout
com.adobe.icc.services.letter
com.adobe.icc.services.locator
com.adobe.icc.services.module
com.adobe.icc.services.render
com.adobe.icc.services.submit
com.adobe.icc.services.user
com.adobe.icc.token
com.adobe.icc.vo
com.adobe.icc.vo.render
com.adobe.icomm.assetplacement.controller
com.adobe.icomm.assetplacement.controller.utils
com.adobe.icomm.assetplacement.data
com.adobe.icomm.assetplacement.model
com.adobe.livecycle.assetmanager.client
com.adobe.livecycle.assetmanager.client.event
com.adobe.livecycle.assetmanager.client.handler
com.adobe.livecycle.assetmanager.client.managers
com.adobe.livecycle.assetmanager.client.model
com.adobe.livecycle.assetmanager.client.model.cms
com.adobe.livecycle.assetmanager.client.service
com.adobe.livecycle.assetmanager.client.service.search
com.adobe.livecycle.assetmanager.client.service.search.cms
com.adobe.livecycle.assetmanager.client.utils
com.adobe.livecycle.content
com.adobe.livecycle.rca.model
com.adobe.livecycle.rca.model.constant
com.adobe.livecycle.rca.model.document
com.adobe.livecycle.rca.model.participant
com.adobe.livecycle.rca.model.reminder
com.adobe.livecycle.rca.model.stage
com.adobe.livecycle.rca.service
com.adobe.livecycle.rca.service.core
com.adobe.livecycle.rca.service.core.delegate
com.adobe.livecycle.rca.service.process
com.adobe.livecycle.rca.service.process.delegate
com.adobe.livecycle.rca.token
com.adobe.livecycle.ria.security.api
com.adobe.livecycle.ria.security.service
com.adobe.mosaic.layouts
com.adobe.mosaic.layouts.dragAndDrop
com.adobe.mosaic.layouts.interfaces
com.adobe.mosaic.mxml
com.adobe.mosaic.om.constants
com.adobe.mosaic.om.events
com.adobe.mosaic.om.impl
com.adobe.mosaic.om.interfaces
com.adobe.mosaic.skinning
com.adobe.mosaic.sparklib.editors
com.adobe.mosaic.sparklib.optionMenu
com.adobe.mosaic.sparklib.scrollableMenu
com.adobe.mosaic.sparklib.scrollableMenu.skins
com.adobe.mosaic.sparklib.tabLayout
com.adobe.mosaic.sparklib.tabLayout.events
com.adobe.mosaic.sparklib.tabLayout.layouts
com.adobe.mosaic.sparklib.tabLayout.skins
com.adobe.mosaic.sparklib.text
com.adobe.mosaic.sparklib.util
com.adobe.solutions.acm.authoring.presentation
com.adobe.solutions.acm.authoring.presentation.actionbar
com.adobe.solutions.acm.authoring.presentation.common
com.adobe.solutions.acm.authoring.presentation.events
com.adobe.solutions.acm.authoring.presentation.fragment
com.adobe.solutions.acm.authoring.presentation.letter
com.adobe.solutions.acm.authoring.presentation.letter.data
com.adobe.solutions.acm.authoring.presentation.preview
com.adobe.solutions.acm.authoring.presentation.rte
com.adobe.solutions.acm.ccr.presentation
com.adobe.solutions.acm.ccr.presentation.contentcapture
com.adobe.solutions.acm.ccr.presentation.contentcapture.events
com.adobe.solutions.acm.ccr.presentation.contentcapture.preview
com.adobe.solutions.acm.ccr.presentation.datacapture
com.adobe.solutions.acm.ccr.presentation.datacapture.renderers
com.adobe.solutions.acm.ccr.presentation.pdf
com.adobe.solutions.exm
com.adobe.solutions.exm.authoring
com.adobe.solutions.exm.authoring.components.controls
com.adobe.solutions.exm.authoring.components.toolbars
com.adobe.solutions.exm.authoring.domain
com.adobe.solutions.exm.authoring.domain.expression
com.adobe.solutions.exm.authoring.domain.impl
com.adobe.solutions.exm.authoring.domain.method
com.adobe.solutions.exm.authoring.domain.variable
com.adobe.solutions.exm.authoring.enum
com.adobe.solutions.exm.authoring.events
com.adobe.solutions.exm.authoring.model
com.adobe.solutions.exm.authoring.renderer
com.adobe.solutions.exm.authoring.view
com.adobe.solutions.exm.expression
com.adobe.solutions.exm.impl
com.adobe.solutions.exm.impl.method
com.adobe.solutions.exm.method
com.adobe.solutions.exm.mock
com.adobe.solutions.exm.mock.method
com.adobe.solutions.exm.runtime
com.adobe.solutions.exm.runtime.impl
com.adobe.solutions.exm.variable
com.adobe.solutions.prm.constant
com.adobe.solutions.prm.domain
com.adobe.solutions.prm.domain.factory
com.adobe.solutions.prm.domain.impl
com.adobe.solutions.prm.domain.manager
com.adobe.solutions.prm.presentation.asset
com.adobe.solutions.prm.presentation.constant
com.adobe.solutions.prm.presentation.document
com.adobe.solutions.prm.presentation.event
com.adobe.solutions.prm.presentation.file
com.adobe.solutions.prm.presentation.project
com.adobe.solutions.prm.presentation.team
com.adobe.solutions.prm.presentation.util
com.adobe.solutions.prm.service
com.adobe.solutions.prm.services.impl
com.adobe.solutions.prm.vo
com.adobe.solutions.rca.constant
com.adobe.solutions.rca.domain
com.adobe.solutions.rca.domain.common
com.adobe.solutions.rca.domain.factory
com.adobe.solutions.rca.domain.impl
com.adobe.solutions.rca.domain.impl.manager
com.adobe.solutions.rca.domain.manager
com.adobe.solutions.rca.presentation
com.adobe.solutions.rca.presentation.comment
com.adobe.solutions.rca.presentation.constant
com.adobe.solutions.rca.presentation.event
com.adobe.solutions.rca.presentation.gantt
com.adobe.solutions.rca.presentation.gantt.ruler
com.adobe.solutions.rca.presentation.template
com.adobe.solutions.rca.presentation.template.audit
com.adobe.solutions.rca.presentation.template.definition
com.adobe.solutions.rca.presentation.template.documents
com.adobe.solutions.rca.presentation.template.stages
com.adobe.solutions.rca.presentation.util
com.adobe.solutions.rca.service
com.adobe.solutions.rca.services.impl
com.adobe.solutions.rca.vo
com.adobe.solutions.rca.vo.um
com.adobe.viewsource
fl.accessibility
fl.containers
fl.controls
fl.controls.dataGridClasses
fl.controls.listClasses
fl.controls.progressBarClasses
fl.core
fl.data
fl.display
fl.events
fl.ik
fl.lang
fl.livepreview
fl.managers
fl.motion
fl.motion.easing
fl.rsl
fl.text
fl.transitions
fl.transitions.easing
fl.video
flash.accessibility
flash.concurrent
flash.crypto
flash.data
flash.desktop
flash.display
flash.display3D
flash.display3D.textures
flash.errors
flash.events
flash.external
flash.filesystem
flash.filters
flash.geom
flash.globalization
flash.html
flash.media
flash.net
flash.net.dns
flash.net.drm
flash.notifications
flash.permissions
flash.printing
flash.profiler
flash.sampler
flash.security
flash.sensors
flash.system
flash.text
flash.text.engine
flash.text.ime
flash.ui
flash.utils
flash.xml
flashx.textLayout
flashx.textLayout.compose
flashx.textLayout.container
flashx.textLayout.conversion
flashx.textLayout.edit
flashx.textLayout.elements
flashx.textLayout.events
flashx.textLayout.factory
flashx.textLayout.formats
flashx.textLayout.operations
flashx.textLayout.utils
flashx.undo
ga.controls
ga.layouts
ga.model
ga.uiComponents
ga.util
ga.views
ga.wrappers
lc.foundation
lc.foundation.domain
lc.foundation.events
lc.foundation.ui
lc.foundation.util
lc.preloader
lc.procmgmt
lc.procmgmt.commands
lc.procmgmt.domain
lc.procmgmt.events
lc.procmgmt.formbridge
lc.procmgmt.impl
lc.procmgmt.ui.attachments
lc.procmgmt.ui.controls
lc.procmgmt.ui.controls.card
lc.procmgmt.ui.controls.renderer
lc.procmgmt.ui.help
lc.procmgmt.ui.layout
lc.procmgmt.ui.presentationmodel
lc.procmgmt.ui.process
lc.procmgmt.ui.search
lc.procmgmt.ui.startpoint
lc.procmgmt.ui.task
lc.procmgmt.ui.task.form
lc.procmgmt.ui.task.form.commands
lc.procmgmt.ui.tracking
mx.accessibility
mx.automation
mx.automation.air
mx.automation.delegates
mx.automation.delegates.advancedDataGrid
mx.automation.delegates.charts
mx.automation.delegates.containers
mx.automation.delegates.controls
mx.automation.delegates.controls.dataGridClasses
mx.automation.delegates.controls.fileSystemClasses
mx.automation.delegates.core
mx.automation.delegates.flashflexkit
mx.automation.events
mx.binding
mx.binding.utils
mx.charts
mx.charts.chartClasses
mx.charts.effects
mx.charts.effects.effectClasses
mx.charts.events
mx.charts.renderers
mx.charts.series
mx.charts.series.items
mx.charts.series.renderData
mx.charts.styles
mx.collections
mx.collections.errors
mx.containers
mx.containers.accordionClasses
mx.containers.dividedBoxClasses
mx.containers.errors
mx.containers.utilityClasses
mx.controls
mx.controls.advancedDataGridClasses
mx.controls.dataGridClasses
mx.controls.listClasses
mx.controls.menuClasses
mx.controls.olapDataGridClasses
mx.controls.scrollClasses
mx.controls.sliderClasses
mx.controls.textClasses
mx.controls.treeClasses
mx.controls.videoClasses
mx.core
mx.core.windowClasses
mx.data
mx.data.crypto
mx.data.errors
mx.data.events
mx.data.messages
mx.data.mxml
mx.data.offline.errors
mx.data.utils
mx.effects
mx.effects.easing
mx.effects.effectClasses
mx.events
mx.filters
mx.flash
mx.formatters
mx.geom
mx.graphics
mx.graphics.codec
mx.graphics.shaderClasses
mx.logging
mx.logging.errors
mx.logging.targets
mx.managers
mx.messaging
mx.messaging.channels
mx.messaging.config
mx.messaging.errors
mx.messaging.events
mx.messaging.management
mx.messaging.messages
mx.modules
mx.netmon
mx.olap
mx.olap.aggregators
mx.preloaders
mx.printing
mx.resources
mx.rpc
mx.rpc.events
mx.rpc.http
mx.rpc.http.mxml
mx.rpc.livecycle
mx.rpc.mxml
mx.rpc.remoting
mx.rpc.remoting.mxml
mx.rpc.soap
mx.rpc.soap.mxml
mx.rpc.wsdl
mx.rpc.xml
mx.skins
mx.skins.halo
mx.skins.spark
mx.skins.wireframe
mx.skins.wireframe.windowChrome
mx.states
mx.styles
mx.utils
mx.validators
org.osmf.containers
org.osmf.display
org.osmf.elements
org.osmf.events
org.osmf.layout
org.osmf.logging
org.osmf.media
org.osmf.metadata
org.osmf.net
org.osmf.net.dvr
org.osmf.net.httpstreaming
org.osmf.net.metrics
org.osmf.net.qos
org.osmf.net.rtmpstreaming
org.osmf.net.rules
org.osmf.traits
org.osmf.utils
spark.accessibility
spark.automation.delegates
spark.automation.delegates.components
spark.automation.delegates.components.gridClasses
spark.automation.delegates.components.mediaClasses
spark.automation.delegates.components.supportClasses
spark.automation.delegates.skins.spark
spark.automation.events
spark.collections
spark.components
spark.components.calendarClasses
spark.components.gridClasses
spark.components.mediaClasses
spark.components.supportClasses
spark.components.windowClasses
spark.core
spark.effects
spark.effects.animation
spark.effects.easing
spark.effects.interpolation
spark.effects.supportClasses
spark.events
spark.filters
spark.formatters
spark.formatters.supportClasses
spark.globalization
spark.globalization.supportClasses
spark.layouts
spark.layouts.supportClasses
spark.managers
spark.modules
spark.preloaders
spark.primitives
spark.primitives.supportClasses
spark.skins
spark.skins.mobile
spark.skins.mobile.supportClasses
spark.skins.spark
spark.skins.spark.mediaClasses.fullScreen
spark.skins.spark.mediaClasses.normal
spark.skins.spark.windowChrome
spark.skins.wireframe
spark.skins.wireframe.mediaClasses
spark.skins.wireframe.mediaClasses.fullScreen
spark.transitions
spark.utils
spark.validators
spark.validators.supportClasses
xd.core.axm.enterprise.view.components
xd.core.axm.enterprise.view.skins
xd.core.axm.view.components
xd.core.axm.view.components.support

Taalelementen

Algemene constanten
Algemene functies
Operatoren
Programmeerinstructies, gereserveerde woorden en compileraanwijzingen
Speciale typen

Bijlagen

Nieuw
Compilerfouten
Compilerwaarschuwingen
Uitvoeringsfouten
Migreren naar ActionScript 3
Ondersteunde tekensets
Alleen MXML-labels
Elementen van bewegings-XML
Timed Text-tags
Lijst van vervangen elementen
Constanten voor toegankelijkheidsimplementatie
ActionScript-voorbeelden gebruiken
Juridische kennisgeving
Pakketflash.system
Klassepublic final class MessageChannel
OverervingMessageChannel Inheritance EventDispatcher Inheritance Object

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

De MessageChannel-klasse biedt twee workers de mogelijkheid om te communiceren. Met een berichtkanaal kan in één richting worden gecommuniceerd. De verzendende worker gebruikt het berichtkanaal om objecten naar de ontvangende worker te sturen. Een MessageChannel-object vormt de enige manier om een bericht tussen workers te verzenden waarbij ook een gebeurtenis kan worden verzonden om aan te geven dat het bericht beschikbaar is. Bij andere methoden voor gegevensdeling kan wel een waarde worden ingesteld, maar kunt u niet via een gebeurtenis op de hoogte worden gebracht van het feit dat gegevens zijn gewijzigd.

Elk MessagChannel bevat een wachtrij met berichtobjecten die van de verzendende worker naar de ontvangende worker worden verzonden. Bij elke aanroep naar send() wordt een object aan de wachtrij toegevoegd. Bij elke aanroep naar receive() wordt het oudste berichtobject uit de wachtrij opgehaald.

U kunt niet rechtstreeks MessageChannel-instanties maken door de WorkerChannel()-constructor aan te roepen. Als u een MessageChannel-instantie wilt maken, roept u de methode createMessageChannel() aan van het Worker-object dat de berichten via het kanaal gaat verzenden. Hierbij geeft u het ontvangende Worker-object door als argument.

De typische workflow voor het verzenden van berichten met een MessageChannel-object is als volgt:

  1. Roep de methode createMessageChannel() van de verzendende worker aan om het berichtkanaal te maken

        // In the sending worker swf
        var sendChannel:MessageChannel;
        sendChannel = Worker.current.createMessageChannel(receivingWorker);
  2. Geef het berichtkanaal door aan de andere worker door Worker.setSharedProperty() aan te roepen of door het kanaal via een bestaand berichtkanaal te verzenden

        receivingWorker.setSharedProperty("incomingChannel", sendChannel);
  3. De code in de ontvangende worker registreert een listener met het MessageChannel-object voor de channelMessage-gebeurtenis.

        // In the receiving worker swf
        var incomingChannel:MessageChannel;
        incomingChannel = Worker.current.getSharedProperty("incomingChannel");
        incomingChannel.addEventListener(Event.CHANNEL_MESSAGE, handleIncomingMessage);
  4. De code in de verzendende worker verstuurt een bericht door de methode send() aan te roepen

        // In the sending worker swf
        sendChannel.send("This is a message");
  5. De runtime roept de gebeurtenishandler in de code van de ontvangende worker aan en geeft hiermee aan dat er een bericht is verzonden

        // 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
        }
  6. De code in de ontvangende worker roept de methode receive() aan om het bericht te ontvangen. Het object dat door de receive()-methode wordt geretourneerd, is van hetzelfde gegevenstype als het object dat werd doorgegeven aan de send()-methode.

        var message:String = incomingChannel.receive() as String;

Naast de bovenstaande asynchrone workflow kunt u met de methode receive() een alternatieve workflow gebruiken waarbij de code in de ontvangende worker wordt gepauzeerd totdat een bericht wordt verzonden. Zie de beschrijving van de methode receive() voor meer informatie.

De MessageChannel-klasse is een van de speciale objecttypen die daadwerkelijk worden gedeeld tussen workers, en niet gekopieerd. Wanneer u een berichtkanaal doorgeeft van één worker naar een andere (door ofwel de methode setSharedProperty() van het Worker-object aan te roepen, of door een MessageChannel-object te gebruiken), beschikken beide workers over een referentie naar een en hetzelfde MessageChannel-object in het geheugen van de runtime.

Verwante API-elementen



Openbare eigenschappen
 EigenschapGedefinieerd door
 Inheritedconstructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.
Object
  messageAvailable : Boolean
[alleen-lezen] Geeft aan of de interne wachtrij van MessageChannel een of meer berichten van de verzendende worker bevat.
MessageChannel
  state : String
[alleen-lezen] Hiermee wordt de huidige status van het MessageChannel-object aangeduid (open, wordt gesloten of gesloten).
MessageChannel
Openbare methoden
 MethodeGedefinieerd door
  
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
[overschrijven] Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.
MessageChannel
  
Instrueert het huidige MessageChannel om te sluiten zodra alle berichten zijn ontvangen.
MessageChannel
 Inherited
Verzendt een gebeurtenis naar de gebeurtenisstroom.
EventDispatcher
 Inherited
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.
EventDispatcher
 Inherited
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.
Object
 Inherited
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.
Object
 Inherited
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.
Object
  
receive(blockUntilReceived:Boolean = false):*
Hiermee wordt een enkel berichtobject opgehaald uit de wachtrij met berichten die via dit berichtenkanaal worden verzonden.
MessageChannel
  
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
[overschrijven] Verwijdert een listener uit het object EventDispatcher.
MessageChannel
  
send(arg:*, queueLimit:int = -1):void
Verstuurt een object van de verzendende worker en voegt dit object toe aan de wachtrij met berichten voor de ontvangende worker.
MessageChannel
 Inherited
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.
Object
 Inherited
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.
Object
  
[overschrijven] Retourneert een tekenreeksrepresentatie van het opgegeven object.
MessageChannel
 Inherited
Retourneert de primitieve waarde van het opgegeven object.
Object
 Inherited
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.
EventDispatcher
Gebeurtenissen
 Gebeurtenis Overzicht Gedefinieerd door
 Inherited[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.EventDispatcher
  Wordt telkens verzonden wanneer de verzendende worker de methode send() van dit MessageChannel-object aanroept om aan te duiden dat er een nieuw berichtobject beschikbaar is in de wachtrij van de MessageChannel-instantie.MessageChannel
  Wordt verzonden wanneer de waarde van de state-eigenschap van het berichtkanaal wordt gewijzigd.MessageChannel
 Inherited[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.EventDispatcher
Eigenschapdetails

messageAvailable

eigenschap
messageAvailable:Boolean  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Geeft aan of de interne wachtrij van MessageChannel een of meer berichten van de verzendende worker bevat.



Implementatie
    public function get messageAvailable():Boolean

state

eigenschap 
state:String  [alleen-lezen]

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Hiermee wordt de huidige status van het MessageChannel-object aangeduid (open, wordt gesloten of gesloten). Mogelijke waarden voor deze eigenschap worden gedefinieerd in de klasse MessageChannelState.



Implementatie
    public function get state():String

Verwante API-elementen

Methodedetails

addEventListener

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. U kunt gebeurtenislisteners registreren op alle knooppunten in het weergaveoverzicht van een specifiek type gebeurtenis, fase of prioriteit.

Nadat het registreren van een gebeurtenislistener is voltooid, kunt u de prioriteit ervan niet wijzigen door extra aanroepen van addEventListener(). Wanneer u de prioriteit van een listener wilt wijzigen, moet u eerst removeListener() aanroepen. U kunt de listener opnieuw registreren met het nieuwe prioriteitsniveau.

Nadat de listener is geregistreerd, resulteren volgende aanroepen van addEventListener() met een andere waarde voor type of useCapture in het maken van een afzonderlijke listenerregistratie. Wanneer u bijvoorbeeld eerst een listener registreert bij useCapture ingesteld op true, luistert deze alleen tijdens de vastlegfase. Wanneer u addEventListener() opnieuw aanroept met hetzelfde listenerobject maar met useCapture ingesteld op false, hebt u twee afzonderlijke listeners: één die tijdens de vastlegfase luistert en één die tijdens de doel- en terugkoppelfasen luistert.

U kunt geen gebeurtenislistener registeren voor alleen de doel- of terugkoppelfase. Deze fasen worden bij de registratie gekoppeld, omdat terugkoppeling alleen van toepassing is op voorouders van het doelknooppunt.

Wanneer u een gebeurtenislistener niet langer nodig hebt, kunt u deze verwijderen door removeEventListener() aan te roepen; anders kan dit resulteren in geheugenproblemen. Gebeurtenisluisteraars worden niet automatisch uit het geheugen verwijderd, omdat de verzamelaar met ongewenste details de luisteraar niet verwijderd zolang het verzendende object bestaat (behalve als de parameter useWeakReference op true is ingesteld).

Het kopiëren van een instantie EventDispatcher kopieert de daaraan gekoppelde gebeurtenislisteners. (Wanneer uw nieuwe knooppunt een gebeurtenislistener nodig heeft, moet u de listener eraan koppelen na het maken van het knooppunt.) Wanneer u echter een instantie EventDispatcher verplaatst, worden de daaraan gekoppelde listeners mee verplaatst.

Wanneer de gebeurtenislistener wordt geregistreerd op een knooppunt terwijl een gebeurtenis op dit knooppunt wordt verwerkt, wordt de gebeurtenislistener niet geactiveerd tijdens de huidige fase maar kan wel worden geactiveerd in een latere fase in de gebeurtenisstroom, zoals de terugkoppelfase.

Wanneer een gebeurtenislistener wordt verwijderd uit een knooppunt terwijl een gebeurtenis wordt verwerkt op het knooppunt, wordt deze nog steeds geactiveerd door de huidige handelingen. Nadat deze is verwijderd, wordt de gebeurtenislistener niet meer aangeroepen (tenzij deze opnieuw wordt geregistreerd voor toekomstige verwerking).

Parameters

type:String — Het type gebeurtenis.
 
listener:Function — De listenerfunctie die de gebeurtenis verwerkt. Deze functie moet een Event-object accepteren als de enige parameter en niets retourneren, zoals in dit voorbeeld wordt getoond:
function(evt:Event):void

De functie kan elke naam hebben.

 
useCapture:Boolean (default = false)Bepaalt of de listener werkt in de vastleg-, doel- en terugkoppelfase. Wanneer useCapture wordt ingesteld op true, verwerkt de listener de gebeurtenis alleen tijdens de vastlegfase en niet tijdens de doel- of terugkoppelfase. Wanneer useCapture wordt ingesteld op false, verwerkt de listener de gebeurtenis alleen tijdens de doel- of terugkoppelfase. Wanneer u in alle drie de fasen naar de gebeurtenis wilt luisteren, roept u addEvenListener() tweemaal aan, één keer met useCapture ingesteld op true en één keer met useCapture ingesteld op false.
 
priority:int (default = 0) — Het prioriteitsniveau van de gebeurtenislistener. De prioriteit is opgegeven door een 32-bits geheel getal. Hoe hoger het getal, hoe hoger de prioriteit. Alle listeners met een prioriteit n worden verwerkt voor listeners met een prioriteit n -1. Wanneer twee of meer listeners dezelfde prioriteit hebben, worden ze verwerkt in de volgorde waarin ze werden toegevoegd. De standaardprioriteit is 0.
 
useWeakReference:Boolean (default = false) — Bepaalt of de verwijzing van de listener sterk of zwak is. Een sterke verwijzing (standaard) voorkomt dat uw listener wordt opgeschoond. Een zwakke verwijzing doet dat niet.

Lidfuncties op klasseniveau worden niet opgeschoond. U kunt dus useWeakReference op true instellen voor deze functies zonder dat deze zullen worden opgeschoond. Wanneer u useWeakReference op true instelt voor een listener die een geneste binnenfunctie is, wordt de functie wel opgeschoond en is deze niet meer blijvend. Wanneer u verwijzingen naar de binnenfunctie maakt (deze opslaat in een andere variabele), wordt de functie niet opgeschoond en blijft deze blijvend.

close

()methode 
public function close():void

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Instrueert het huidige MessageChannel om te sluiten zodra alle berichten zijn ontvangen.

Zodra u deze methode aanroept, kunt u de methode send() niet meer aanroepen om berichten toe te voegen aan de wachtrij. Als u send() toch aanroept, mislukt de aanroep en wordt de waarde false geretourneerd.

U kunt ook alleen de methode receive() aanroepen om berichten te ontvangen die al in de wachtrij zijn geplaatst. Als de wachtrij leeg is, retourneert de receive()-aanroep de waarde null.


Gebeurtenissen
channelState:Event — verzonden wanneer de methode close() wordt aangeroepen (en waarmee de state-eigenschap wordt ingesteld op MessageChannelState.CLOSING). Nogmaals verzonden wanneer alle berichten zijn ontvangen en de state-eigenschap wordt ingesteld op MessageChannelState.CLOSED.

receive

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Hiermee wordt een enkel berichtobject opgehaald uit de wachtrij met berichten die via dit berichtenkanaal worden verzonden.

Telkens wanneer de methode send() van het MessageChannel-object wordt aangeroepen door de code van de verzendende worker, wordt een enkel object toegevoegd aan de interne wachtrij van het berichtkanaal. Deze objecten worden in de wachtrij geplaatst, totdat ze achtereenvolgens worden opgehaald door de verzendende worker die de methode receive() aanroept. De berichtobjecten worden ontvangen in de volgorde waarin ze zijn verzonden.

Als u wilt controleren of de wachtrij een berichtobject bevat dat kan worden ontvangen, gebruikt u de eigenschap messageAvailable.

Normaal gesproken wordt het object dat aan de methode send() wordt via serienummering doorgegeven in de AMF3-indeling. Wanneer het object uit de wachtrij wordt gehaald door de receive()-aanroep, wordt het object via serienummering omgezet in een ActionScript-object (een kopie van het oorspronkelijke object) in de ontvangende worker en ontvangt de worker een referentie naar die kopie. Sommige objecttypen worden gedeeld tussen workers, en niet gekopieerd. In dat geval is het object dat de ontvangende worker krijgt, een referentie naar het gedeelde object en geen kopie ervan. Zie de beschrijving van de methode send() voor meer informatie hierover.

Het gedrag van de methode verandert als de wachtrij leeg is en u de waarde true doorgeeft voor de blockUntilReceived-parameter. In dat geval pauzeert de worker de bijbehorende uitvoeringsthread bij de receive()-aanroep en wordt er geen code meer uitgevoerd. Zodra de verzendende worker send() aanroept, wordt de receive()-aanroep voltooid doordat het bericht wordt ontvangen. Hierna vervolgt de worker de uitvoering met de code die volgt op de receive-aanroep.

Parameters

blockUntilReceived:Boolean (default = false) — geeft aan of de uitvoeringsthread van de worker een berichtobject moet ontvangen waarna de uitvoering wordt voortgezet (false), of dat de thread moet pauzeren bij de receive()-aanroep en wachten op een bericht dat wordt verzonden wanneer de wachtrij leeg is (true)

Geretourneerde waarde
* — een kopie van het object dat wordt doorgegeven aan de methode send() door de verzendende worker. Als het object een van de speciale objecttypen is die daadwerkelijk worden gedeeld tussen workers, is de geretourneerde waarde een referentie naar het gedeelde object en geen kopie ervan. Als er geen bericht beschikbaar is in de wachtrij, wordt de waarde null geretourneerd door de methode.

Gegenereerde uitzondering
IOError — als het kanaal wordt gesloten op het tijdstip dat de methode wordt aangeroepen, of als het argument blockUntilReceived leidt tot het pauzeren van de uitvoering en het kanaal vervolgens wordt gesloten door een andere worker.
 
ArgumentError — als de aanroepende code zich niet in de ontvangende worker bevindt
 
ScriptTimeoutError — als de methode wordt aangeroepen door code in de 'primordial worker' in Flash Player en het argument blockUntilReceived ervoor zorgt dat de worker langer pauzeert dan de time-outlimiet voor scripts (standaard ingesteld op 15 seconden)

Verwante API-elementen

removeEventListener

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Verwijdert een listener uit het object EventDispatcher. Wanneer geen overeenkomende listener is geregistreerd bij het object EventDispatcher, heeft een aanroep van deze methode geen invloed.

Parameters

type:String — Het type gebeurtenis.
 
listener:Function — Het listenerobject dat wordt verwijderd.
 
useCapture:Boolean (default = false)Geeft aan of de listener is geregistreerd voor de vastleg-, doel- en terugkoppelfase. Wanneer de listener is geregistreerd voor zowel de vastlegfase als de doel- en terugkoppelfase, zijn twee aanroepen van de removeEventListener() nodig om beide te verwijderen, één met useCapture ingesteld op true en één met useCapture ingesteld op false.

send

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

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Verstuurt een object van de verzendende worker en voegt dit object toe aan de wachtrij met berichten voor de ontvangende worker.

Praktisch elk object kan worden doorgegeven aan de arg-parameter. Met uitzondering van de onderstaande objecten, worden objecten die zijn doorgegeven aan de arg-parameter, niet als referentie doorgegeven. Wijzigingen die worden doorgevoerd in het object van een worker nadat send() is aangeroepen, worden niet doorgevoerd in de andere worker. Wanneer receive() wordt aangeroepen, wordt het object via serienummering gekopieerd naar de AMF3-indeling en vervolgens weer via serienummering omgezet in een nieuw object in de ontvangende worker. Dit is ook waarom objecten die niet via serienummering kunnen worden omgezet in een AMF-indeling (zoals bijvoorbeeld weergaveobjecten), niet kunnen worden doorgegeven aan de arg-parameter. Voor een juiste doorgave van een aangepaste klasse moet de klassendefinitie worden geregistreerd met de functie flash.net.registerClassAlias() of met [RemoteClass]-metagegevens. Voor beide methoden geldt dat hetzelfde alias moet worden gebruikt voor de klassenversies van beide workers.

Er zijn vijf objecttypen die een uitzondering vormen op de regel dat objecten niet daadwerkelijk worden gedeeld door workers:

  • Worker-item 
  • MessageChannel
  • deelbare ByteArray (een ByteArray-object waarvan de eigenschap shareable is ingesteld op true
  • Mutex
  • Condition

Wanneer u een instantie van een van deze objecten doorgeeft met de arg-parameter, beschikt elke worker over een referentie naar hetzelfde onderliggende object. Wijzigingen die in één worker worden toegepast op een instantie zijn dan direct beschikbaar in alle andere workers. Bovendien geldt dat als u eenzelfde instantie van deze objecten meerdere keren doorgeeft aan een worker met behulp van send(), er niet telkens een nieuw exemplaar van het object in de ontvangende worker wordt gemaakt door de runtime. In plaats hiervan wordt dezelfde referentie opnieuw gebruikt, waardoor er minder systeemgeheugen in beslag wordt genomen.

Bij deze methode wordt het object standaard toegevoegd aan de wachtrij, waarna de volgende coderegel direct wordt uitgevoerd. Als u wilt voorkomen dat de wachtrij te groot wordt, kunt u met de parameter queueLimit aangeven hoeveel items maximaal in de wachtrij zijn toegestaan. Wanneer de wachtrij meer items bevat dan de door u opgegeven limiet en de methode send() wordt aangeroepen, pauzeert de worker de uitvoeringsthread bij de send()-aanroep. Wanneer de ontvangende worker voldoende receive()-aanroepen heeft uitgevoerd en de limiet voor de wachtrij niet meer wordt overschreden, wordt de send()-aanroep voltooid. Hierna vervolgt de worker de uitvoering vanaf de volgende coderegel.

Parameters

arg:* — het object dat moet worden toegevoegd aan de wachtrij
 
queueLimit:int (default = -1) — het maximale aantal berichtobjecten dat de wachtrij kan bevatten. Als de wachtrij meer objecten bevat dan is toegestaan volgens de limiet, pauzeert de verzendende worker totdat er een aantal berichten is ontvangen en de limietwaarde van de wachtrij weer is bereikt.


Gebeurtenissen
channelMessage:Event — verzonden om aan te geven aan de ontvangende worker dat er een berichtobject beschikbaar is in de wachtrij

Gegenereerde uitzondering
IOError — als het kanaal wordt gesloten op het tijdstip dat de methode wordt aangeroepen, of als het argument queueLimit leidt tot het pauzeren van de uitvoering en het kanaal vervolgens wordt gesloten door een andere worker.
 
ArgumentError — als de aanroepende code zich niet in de verzendende worker bevindt
 
ScriptTimeoutError — als de methode wordt aangeroepen door code in de 'primordial worker' in Flash Player en het argument queueLimit ervoor zorgt dat de worker langer pauzeert dan de time-outlimiet voor scripts (standaard ingesteld op 15 seconden)

Verwante API-elementen

toString

()methode 
override public function toString():String

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Retourneert een tekenreeksrepresentatie van het opgegeven object.

Opmerking: methoden van de klasse Object worden dynamisch gemaakt in het prototype van Object. Wanneer u deze methode opnieuw wilt definiëren in een subklasse van Object, moet u het trefwoord override niet gebruiken. Bijvoorbeeld, een subklasse van Object implementeert de functie toString():String in plaats van dat deze de basisklasse overschrijft.

Geretourneerde waarde
String — De tekenreeksrepresentatie van het object.
Gebeurtenisdetails

channelMessage

Gebeurtenis
Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.CHANNEL_MESSAGE

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Wordt telkens verzonden wanneer de verzendende worker de methode send() van dit MessageChannel-object aanroept om aan te duiden dat er een nieuw berichtobject beschikbaar is in de wachtrij van de MessageChannel-instantie.

De constante Event.CHANNEL_MESSAGE definieert de waarde van de type-eigenschap van een channelMessage-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

EigenschapWaarde
bubblesfalse
cancelablefalse; er is geen standaardgedrag om te annuleren.
currentTargetHet object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
targetHet object dat deze gebeurtenis heeft verzonden.

channelState

Gebeurtenis  
Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.CHANNEL_STATE

Taalversie: ActionScript 3.0
Runtimeversies: Flash Player 11.4, AIR 3.4

Wordt verzonden wanneer de waarde van de state-eigenschap van het berichtkanaal wordt gewijzigd.

De constante Event.CHANNEL_STATE definieert de waarde van de type-eigenschap van een channelState-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

EigenschapWaarde
bubblesfalse
cancelablefalse; er is geen standaardgedrag om te annuleren.
currentTargetHet object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
targetHet object dat deze gebeurtenis heeft verzonden.




[ X ]Waarom in het Engels?
Sommige inhoud van de Naslaggids voor ActionScript 3.0 staat in het Engels

Niet alle onderdelen van de Naslaggids voor ActionScript 3.0 zijn in alle talen vertaald. Wanneer een taalelement niet is vertaald, wordt het in het Engels weergegeven. Zo is de klasse ga.controls.HelpBox niet in elke taal vertaald. In de Nederlandse versie van de naslaggids wordt de klasse ga.controls.HelpBox bijvoorbeeld in het Engels weergegeven.