|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* Event class file.
|
|
|
|
*
|
|
|
|
* @link http://www.yiiframework.com/
|
|
|
|
* @copyright Copyright © 2008-2012 Yii Software LLC
|
|
|
|
* @license http://www.yiiframework.com/license/
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace yii\base;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Event is the base class for all event classes.
|
|
|
|
*
|
|
|
|
* It encapsulates the parameters associated with an event.
|
|
|
|
* The [[sender]] property describes who raises the event.
|
|
|
|
* And the [[handled]] property indicates if the event is handled.
|
|
|
|
* If an event handler sets [[handled]] to be true, the rest of the
|
|
|
|
* uninvoked handlers will no longer be called to handle the event.
|
|
|
|
* Additionally, an event may specify extra parameters via the [[params]] property.
|
|
|
|
*
|
|
|
|
* @author Qiang Xue <qiang.xue@gmail.com>
|
|
|
|
* @since 2.0
|
|
|
|
*/
|
|
|
|
class Event extends Object
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* @var string the event name. This property is set by [[Component::raiseEvent]].
|
|
|
|
* Event handlers may use this property to check what event it is handling.
|
|
|
|
* The event name is in lower case.
|
|
|
|
*/
|
|
|
|
public $name;
|
|
|
|
/**
|
|
|
|
* @var object the sender of this event
|
|
|
|
*/
|
|
|
|
public $sender;
|
|
|
|
/**
|
|
|
|
* @var boolean whether the event is handled. Defaults to false.
|
|
|
|
* When a handler sets this to be true, the event processing will stop and
|
|
|
|
* ignore the rest of the uninvoked event handlers.
|
|
|
|
*/
|
|
|
|
public $handled = false;
|
|
|
|
/**
|
|
|
|
* @var mixed extra parameters associated with the event.
|
|
|
|
*/
|
|
|
|
public $params;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Constructor.
|
|
|
|
* @param mixed $sender sender of the event
|
|
|
|
*/
|
|
|
|
public function __construct($sender=null, $params=null)
|
|
|
|
{
|
|
|
|
$this->sender = $sender;
|
|
|
|
$this->params = $params;
|
|
|
|
}
|
|
|
|
}
|