{@link setAcceptCssClass AcceptCssClass} : a coma delimited classname of elements that the drop container can accept.
* {@link setHoverCssClass HoverCssClass}: CSS classname of the container when a draggable element hovers over the container.
*
* Events:
*
* {@link OnDrop OnDrop} : raised when a TDraggable control is dropped. The dropped control id is encapsulated in the event parameter,
* as well as mouse coordinates and key modifiers status
*
*
* @author Christophe BOULAIN (Christophe.Boulain@gmail.com)
* @copyright Copyright © 2008, PradoSoft
* @license http://www.pradosoft.com/license
* @version $Id: TDropContainer.php 3285 2013-04-11 07:28:07Z ctrlaltca $
* @package System.Web.UI.ActiveControls
*/
class TDropContainer extends TPanel implements IActiveControl, ICallbackEventHandler
{
private $_container=null;
/**
* Creates a new callback control, sets the adapter to
* TActiveControlAdapter. If you override this class, be sure to set the
* adapter appropriately by, for example, by calling this constructor.
*/
public function __construct()
{
parent::__construct();
$this->setAdapter(new TActiveControlAdapter($this));
}
/**
* @return TBaseActiveControl standard active control options.
*/
public function getActiveControl()
{
return $this->getAdapter()->getBaseActiveControl();
}
/**
* @return TCallbackClientSide client side request options.
*/
public function getClientSide()
{
return $this->getAdapter()->getBaseActiveControl()->getClientSide();
}
/**
* Gets the Css class name that this container can accept.
* @return string
*/
public function getAcceptCssClass()
{
return $this->getViewState('Accepts', '');
}
/**
* Sets the Css class name that this container can accept.
* @param string comma delimited css class names.
*/
public function setAcceptCssClass($value)
{
$this->setViewState('Accepts', TPropertyValue::ensureArray($value), '');
}
/**
* Sets the Css class name used when a draggble element is hovering
* over this container.
* @param string css class name during draggable hover.
*/
public function setHoverCssClass($value)
{
$this->setViewState('HoverClass', $value, '');
}
/**
* Gets the Css class name used when a draggble element is hovering
* over this container.
* @return string css class name during draggable hover.
*/
public function getHoverCssClass()
{
return $this->getViewState('HoverClass', '');
}
/**
* Raises callback event. This method is required bu {@link ICallbackEventHandler}
* interface.
* It raises the {@link onDrop OnDrop} event, then, the {@link onCallback OnCallback} event
* This method is mainly used by framework and control developers.
* @param TCallbackEventParameter the parameter associated with the callback event
*/
public function raiseCallbackEvent($param)
{
$this->onDrop($param->getCallbackParameter());
$this->onCallback($param);
}
/**
* Raises the onDrop event.
* The drop parameters are encapsulated into a {@link TDropContainerEventParameter}
*
* @param object $dropControlId
*/
public function onDrop ($dropParams)
{
$this->raiseEvent('OnDrop', $this, new TDropContainerEventParameter ($dropParams));
}
/**
* This method is invoked when a callback is requested. The method raises
* 'OnCallback' event to fire up the event handlers. If you override this
* method, be sure to call the parent implementation so that the event
* handler can be invoked.
* @param TCallbackEventParameter event parameter to be passed to the event handlers
*/
public function onCallback($param)
{
$this->raiseEvent('OnCallback', $this, $param);
}
/**
* Gets the post back options for this textbox.
* @return array
*/
protected function getPostBackOptions()
{
$options['ID'] = $this->getClientID();
$options['EventTarget'] = $this->getUniqueID();
$options['accept'] = $this->getAcceptCssClass();
$options['hoverclass'] = $this->getHoverCssClass();
return $options;
}
/**
* Gets the name of the javascript class responsible for performing postback for this control.
* This method overrides the parent implementation.
* @return string the javascript class name
*/
protected function getClientClassName()
{
return 'Prado.WebUI.DropContainer';
}
/**
* Registers clientscripts
*
* This method overrides the parent implementation and is invoked before render.
* @param mixed event parameter
*/
public function onPreRender($param)
{
parent::onPreRender($param);
}
/**
* Ensure that the ID attribute is rendered and registers the javascript code
* for initializing the active control.
*/
protected function addAttributesToRender($writer)
{
parent::addAttributesToRender($writer);
$writer->addAttribute('id',$this->getClientID());
$this->getPage()->getClientScript()->registerPradoScript('dragdrop');
$this->getActiveControl()->registerCallbackClientScript(
$this->getClientClassName(), $this->getPostBackOptions());
}
/**
* Creates child control
* Override parent implementation to create a container which will contain all
* child controls. This container will be a TActivePanel, in order to allow user
* to update its content on callback.
*/
public function createChildControls ()
{
if ($this->_container===null)
{
$this->_container=Prado::CreateComponent('System.Web.UI.ActiveControls.TActivePanel');
$this->_container->setId($this->getId(false).'_content');
parent::getControls()->add($this->_container);
}
}
/**
* Override parent implementation to return the container control collection.
*
* @return TControlCollection
*/
public function getControls()
{
$this->ensureChildControls();
return $this->_container->getControls();
}
/**
* Renders and replaces the panel's content on the client-side.
* When render() is called before the OnPreRender event, such as when render()
* is called during a callback event handler, the rendering
* is defered until OnPreRender event is raised.
* @param THtmlWriter html writer
*/
public function render ($writer)
{
if($this->getHasPreRendered())
{
parent::render($writer);
if($this->getActiveControl()->canUpdateClientSide())
$this->getPage()->getCallbackClient()->replaceContent($this->_container,$writer);
}
else
{
$this->getPage()->getAdapter()->registerControlToRender($this->_container,$writer);
}
}
}
/**
* TDropContainerEventParameter class
*
* TDropContainerEventParameter encapsulate the parameter
* data for OnDrop event of TDropContainer components
*
* @author Christophe BOULAIN (Christophe.Boulain@ceram.fr)
* @copyright Copyright © 2008, PradoSoft
* @license http://www.pradosoft.com/license
* @version $Id: TDropContainer.php 3285 2013-04-11 07:28:07Z ctrlaltca $
* @package System.Web.UI.ActiveControls
*/
class TDropContainerEventParameter extends TEventParameter
{
private $_dragElementId;
private $_screenX;
private $_screenY;
private $_offsetX;
private $_offsetY;
private $_clientX;
private $_clientY;
private $_shiftKey;
private $_ctrlKey;
private $_altKey;
public function __construct($dropParams)
{
$this->_dragElementId = $dropParams->DragElementID;
$this->_screenX = $dropParams->ScreenX;
$this->_screenY = $dropParams->ScreenY;
$this->_offsetX = isset($dropParams->OffsetX) ? $dropParams->OffsetX : false;
$this->_offsetY = isset($dropParams->OffsetY) ? $dropParams->OffsetY : false;
$this->_clientX = $dropParams->ClientX;
$this->_clientY = $dropParams->ClientY;
$this->_shiftKey = TPropertyValue::ensureBoolean($dropParams->ShiftKey);
$this->_ctrlKey = TPropertyValue::ensureBoolean($dropParams->CtrlKey);
$this->_altKey = TPropertyValue::ensureBoolean($dropParams->AltKey);
}
public function getDragElementId() { return $this->_dragElementId; }
public function getScreenX() { return $this->_screenX; }
public function getScreenY() { return $this->_screenY; }
public function getOffsetX() { return $this->_offsetX; }
public function geOffsetY() { return $this->_offsetY; }
public function getClientX() { return $this->_clientX; }
public function getClientY() { return $this->_clientY; }
public function getShiftKey() { return $this->_shiftKey; }
public function getCtrlKey() { return $this->_ctrlKey; }
public function getAltKey() { return $this->_altKey; }
/**
* GetDroppedControl
*
* Compatibility method to get the dropped control
* @return TControl dropped control, or null if not found
*/
public function getDroppedControl ()
{
$control=null;
$service=prado::getApplication()->getService();
if ($service instanceof TPageService)
{
// Find the control
// Warning, this will not work if you have a '_' in your control Id !
$dropControlId=str_replace(TControl::CLIENT_ID_SEPARATOR,TControl::ID_SEPARATOR,$this->_dragElementId);
$control=$service->getRequestedPage()->findControl($dropControlId);
}
return $control;
}
}