Object Class: _receive

Object Class: _receive

Receives a broadcast message from another object

Syntax
Details

Syntax

objectName._receive( message, numArg,charArg,senderID );

Argument Type Use Description

message Character Input specifies the message broadcast from the sender through the _broadcast method

numArg Numeric Input specifies the numeric argument broadcast from the sender

charArg Character Input specifies the character argument broadcast from the sender

senderID Numeric Input specifies the object identifier of the sender

Argument	Type	Use	Description
message	Character	Input	specifies the message broadcast from the sender through the _broadcast method
numArg	Numeric	Input	specifies the numeric argument broadcast from the sender
charArg	Character	Input	specifies the character argument broadcast from the sender
senderID	Numeric	Input	specifies the object identifier of the sender

Details

When a message is sent from one object to another with the _broadcast method, SAS/AF software invokes the _receive method of each object in the sender's _receivers list. This is true only when the value of the charMsg parameter being broadcast is the name of an item on the recipient's _receive list or if the receiver or the receiver's class does not have a _receive list.

The numArg and charArg passed from the sender via the _broadcast method are forwarded to the receiver via the same parameters in the _receive parameters list, and the object identifier of the sender is passed as well, allowing the receiver to query the sender for additional data if necessary.

You can use an SCL list to pass a number of values from the sender to the recipient by specifying the list identifier in numArg.

Note: It is recommended that you implement component communication using attribute linking, event handling, or model/view. [cautionend]

Chapter Contents
Previous
Next
Top of Page