(C) 1998 AROS - The Amiga Research OS


NAME
#include <>
#include <proto/commodities.h>

VOID DivertCxMsg (cxm , headObj , returnObj)

LOCATION
In CxBase at offset 26

SYNOPSIS
CxMsg * cxm
CxObj * headObj
CxObj * returnObj

FUNCTION
Send the commodity message 'cxm' down the list of objects connected to 'headObj' and set the destination to 'returnObj'. This means that when the message has travelled through the objects within the 'headObj' tree, the _successor_ of returnObj will receive the message.

INPUTS
cxm
- the message to be diverted.
headObj
- the start object
returnObj
- the successor of this object will get the message after travelling through 'headObj' and friends.

RESULT

EXAMPLE
    When a filter gets a message that matches with its description, it
    sends the message down its list using:

DivertCxMsg(msg, filter, filter);
SEE ALSO
RouteCxMsg()

NOTES

BUGS

INTERNALS

HISTORY
18.07.1999 SDuvan
Finally -- commodities.library