PEAR Manual
Prev |  | Next

# Event_Dispatcher::addNestedDispatcher()

Event_Dispatcher::addNestedDispatcher() -- Add a nested dispatcher.

## Synopsis

    require_once 'Event/Dispatcher.php';

``void Event_Dispatcher::addNestedDispatcher` (object Event_Dispatcher &$dispatcher)`

## Description

Adds a nested dispatcher to the dispatcher.

Nested dispatchers allow you to create event bubbling like it is implemented in Javascript. After an event has been posted to all observers of the dispatcher, it will be broadcasted to all nested dispatchers.

If you have one dispatcher that dispatches events of a component in your framework and one dispatcher that dispatches global events that are triggered by the framework itself it could make sense that you nest these dispatchers, so that events posted by the component dispatcher will also be broadcasted to the global dispatcher.

## Parameter

- object Event_Dispatcher `&$dispatcher`

  Dispatcher that should be added as a nested dispatcher to the current dispatcher.

## Return value

void

## Note

This function can not be called statically.

Prev | Home | Next
Event_Dispatcher::post() | Up | Event_Dispatcher::removeNestedDispatcher()