<?php

[0] Fix | Delete

[1] Fix | Delete

/*

[2] Fix | Delete

* This file is part of the Symfony package.

[3] Fix | Delete

*

[4] Fix | Delete

* (c) Fabien Potencier <fabien@symfony.com>

[5] Fix | Delete

*

[6] Fix | Delete

* For the full copyright and license information, please view the LICENSE

[7] Fix | Delete

* file that was distributed with this source code.

[8] Fix | Delete

*/

[9] Fix | Delete

[10] Fix | Delete

namespace Symfony\Component\EventDispatcher;

[11] Fix | Delete

[12] Fix | Delete

/**

[13] Fix | Delete

* Event is the base class for classes containing event data.

[14] Fix | Delete

*

[15] Fix | Delete

* This class contains no event data. It is used by events that do not pass

[16] Fix | Delete

* state information to an event handler when an event is raised.

[17] Fix | Delete

*

[18] Fix | Delete

* You can call the method stopPropagation() to abort the execution of

[19] Fix | Delete

* further listeners in your event listener.

[20] Fix | Delete

*

[21] Fix | Delete

* @author Guilherme Blanco <guilhermeblanco@hotmail.com>

[22] Fix | Delete

* @author Jonathan Wage <jonwage@gmail.com>

[23] Fix | Delete

* @author Roman Borschel <roman@code-factory.org>

[24] Fix | Delete

* @author Bernhard Schussek <bschussek@gmail.com>

[25] Fix | Delete

*/

[26] Fix | Delete

class Event

[27] Fix | Delete

{

[28] Fix | Delete

/**

[29] Fix | Delete

* @var bool Whether no further event listeners should be triggered

[30] Fix | Delete

*/

[31] Fix | Delete

private $propagationStopped = false;

[32] Fix | Delete

[33] Fix | Delete

/**

[34] Fix | Delete

* @var EventDispatcherInterface Dispatcher that dispatched this event

[35] Fix | Delete

*/

[36] Fix | Delete

private $dispatcher;

[37] Fix | Delete

[38] Fix | Delete

/**

[39] Fix | Delete

* @var string This event's name

[40] Fix | Delete

*/

[41] Fix | Delete

private $name;

[42] Fix | Delete

[43] Fix | Delete

/**

[44] Fix | Delete

* Returns whether further event listeners should be triggered.

[45] Fix | Delete

*

[46] Fix | Delete

* @see Event::stopPropagation()

[47] Fix | Delete

*

[48] Fix | Delete

* @return bool Whether propagation was already stopped for this event

[49] Fix | Delete

*/

[50] Fix | Delete

public function isPropagationStopped()

[51] Fix | Delete

{

[52] Fix | Delete

return $this->propagationStopped;

[53] Fix | Delete

}

[54] Fix | Delete

[55] Fix | Delete

/**

[56] Fix | Delete

* Stops the propagation of the event to further event listeners.

[57] Fix | Delete

*

[58] Fix | Delete

* If multiple event listeners are connected to the same event, no

[59] Fix | Delete

* further event listener will be triggered once any trigger calls

[60] Fix | Delete

* stopPropagation().

[61] Fix | Delete

*/

[62] Fix | Delete

public function stopPropagation()

[63] Fix | Delete

{

[64] Fix | Delete

$this->propagationStopped = true;

[65] Fix | Delete

}

[66] Fix | Delete

[67] Fix | Delete

/**

[68] Fix | Delete

* Stores the EventDispatcher that dispatches this Event.

[69] Fix | Delete

*

[70] Fix | Delete

* @param EventDispatcherInterface $dispatcher

[71] Fix | Delete

*

[72] Fix | Delete

* @deprecated since version 2.4, to be removed in 3.0. The event dispatcher is passed to the listener call.

[73] Fix | Delete

*/

[74] Fix | Delete

public function setDispatcher(EventDispatcherInterface $dispatcher)

[75] Fix | Delete

{

[76] Fix | Delete

$this->dispatcher = $dispatcher;

[77] Fix | Delete

}

[78] Fix | Delete

[79] Fix | Delete

/**

[80] Fix | Delete

* Returns the EventDispatcher that dispatches this Event.

[81] Fix | Delete

*

[82] Fix | Delete

* @return EventDispatcherInterface

[83] Fix | Delete

*

[84] Fix | Delete

* @deprecated since version 2.4, to be removed in 3.0. The event dispatcher is passed to the listener call.

[85] Fix | Delete

*/

[86] Fix | Delete

public function getDispatcher()

[87] Fix | Delete

{

[88] Fix | Delete

@trigger_error('The '.__METHOD__.' method is deprecated since Symfony 2.4 and will be removed in 3.0. The event dispatcher instance can be received in the listener call instead.', E_USER_DEPRECATED);

[89] Fix | Delete

[90] Fix | Delete

return $this->dispatcher;

[91] Fix | Delete

}

[92] Fix | Delete

[93] Fix | Delete

/**

[94] Fix | Delete

* Gets the event's name.

[95] Fix | Delete

*

[96] Fix | Delete

* @return string

[97] Fix | Delete

*

[98] Fix | Delete

* @deprecated since version 2.4, to be removed in 3.0. The event name is passed to the listener call.

[99] Fix | Delete

*/

[100] Fix | Delete

public function getName()

[101] Fix | Delete

{

[102] Fix | Delete

@trigger_error('The '.__METHOD__.' method is deprecated since Symfony 2.4 and will be removed in 3.0. The event name can be received in the listener call instead.', E_USER_DEPRECATED);

[103] Fix | Delete

[104] Fix | Delete

return $this->name;

[105] Fix | Delete

}

[106] Fix | Delete

[107] Fix | Delete

/**

[108] Fix | Delete

* Sets the event's name property.

[109] Fix | Delete

*

[110] Fix | Delete

* @param string $name The event name

[111] Fix | Delete

*

[112] Fix | Delete

* @deprecated since version 2.4, to be removed in 3.0. The event name is passed to the listener call.

[113] Fix | Delete

*/

[114] Fix | Delete

public function setName($name)

[115] Fix | Delete

{

[116] Fix | Delete

$this->name = $name;

[117] Fix | Delete

}

[118] Fix | Delete

}

[119] Fix | Delete

[120] Fix | Delete