Added TDataBoundControl, TDropDownList and TListBox. Note, they're not done yet.

4 files changed, 388 insertions, 2 deletions

diff --git a/framework/Web/UI/WebControls/TCheckBox.php b/framework/Web/UI/WebControls/TCheckBox.php
index 2f51d8f5..72d15822 100644
--- a/framework/Web/UI/WebControls/TCheckBox.php
+++ b/framework/Web/UI/WebControls/TCheckBox.php
@@ -102,8 +102,6 @@ class TCheckBox extends TWebControl implements IPostBackDataHandler, IValidatabl
 	 * This is necessary because a checkbox if unchecked, when postback,

 	 * does not have direct mapping between post data and the checkbox name.

 	 *

-	 * Auto-postback javascript code is also registered here.

-	 *

 	 * This method overrides the parent implementation and is invoked before render.

 	 * @param mixed event parameter

 	 */

diff --git a/framework/Web/UI/WebControls/TDataBoundControl.php b/framework/Web/UI/WebControls/TDataBoundControl.php
new file mode 100644
index 00000000..032370f7
--- /dev/null
+++ b/framework/Web/UI/WebControls/TDataBoundControl.php
@@ -0,0 +1,260 @@
+<?php

+

+abstract class TDataBoundControl extends TWebControl

+{

+	private $_initialized=false;

+	private $_dataSource=null;

+	private $_requiresBindToNull=false;

+	private $_requiresDataBinding=false;

+	private $_throwOnDataPropertyChange=false;

+	private $_prerendered=false;

+

+	/**

+	 * @return Traversable data source object, defaults to null.

+	 */

+	public function getDataSource()

+	{

+		return $this->_dataSource;

+	}

+

+	/**

+	 * @param Traversable|array|string data source object

+	 */

+	public function setDataSource($value)

+	{

+		if($value!==null)

+			$this->validateDataSource($value);

+		$this->_dataSource=$value;

+		$this->onDataPropertyChanged();

+	}

+

+	/**

+	 * @return string ID path to the data source control. Defaults to empty.

+	 */

+	public function getDataSourceID()

+	{

+		return $this->getViewState('DataSourceID','');

+	}

+

+	/**

+	 * @param string ID path to the data source control. The data source

+	 * control must be locatable via {@link TControl::findControl} call.

+	 */

+	public function setDataSourceID($value)

+	{

+		$dsid=$this->getViewState('DataSourceID','');

+		if($dsid!=='' && $value==='')

+			$this->_requiresBindToNull=true;

+		$this->setViewState('DataSourceID',$value,'');

+		$this->onDataPropertyChanged();

+	}

+

+	/**

+	 * This method is invoked when either {@link setDataSource} or {@link setDataSourceID} is changed.

+	 */

+	protected function onDataPropertyChanged()

+	{

+		if($this->_throwOnDataPropertyChanged)

+			throw new TInvalidOperationException('databoundcontrol_dataproperty_unchangeable');

+		if($this->getInitialized())

+			$this->setRequiresDataBinding(true);

+	}

+

+	/**

+	 * @return boolean whether the databound control has been initialized.

+	 */

+	protected function getInitialized()

+	{

+		return $this->_initialized;

+	}

+

+	/**

+	 * @param boolean a value indicating whether the databound control is initialized.

+	 */

+	protected function setInitialized($value)

+	{

+		$this->_initialized=TPropertyValue::ensureBoolean($value);

+	}

+

+	/**

+	 * @return boolean if the databound control uses the data source control specified

+	 * by {@link setDataSourceID}, or it uses the data source object specified

+	 * by {@link setDataSource}.

+	 */

+	protected function getUsingDataSourceID()

+	{

+		return $this->getDataSourceID()!=='';

+	}

+

+	/**

+	 * @return boolean whether a databind call is required (by the data bound control)

+	 */

+	protected function getRequiresDataBinding()

+	{

+		return $this->_requiresDataBinding;

+	}

+

+	/**

+	 * Sets a value indicating whether a databind call is required by the data bound control.

+	 * If true and the control has been prerendered while it uses the data source

+	 * specified by {@link setDataSourceID}, a databind call will be called by this method.

+	 * @param boolean whether a databind call is required.

+	 */

+	protected function setRequiresDataBinding($value)

+	{

+		$value=TPropertyValue::ensureBoolean($value);

+		if($value && $this->_prerendered && $this->getUsingDataSourceID())

+		{

+			$this->_requiresDataBinding=true;

+			$this->ensureDataBound();

+		}

+		else

+			$this->_requiresDataBinding=$value;

+	}

+

+	/**

+	 * Performs databinding.

+	 * This method overrides the parent implementation by calling

+	 * {@link performSelect} which fetches data from data source and does

+	 * the actual binding work.

+	 * @param boolean whether to raise DataBind event. This parameter is ignored.

+	 */

+	public function dataBind($raiseDataBindingEvent=true)

+	{

+		$this->performSelect();

+	}

+

+	/**

+	 * Ensures any pending {@link dataBind} is called.

+	 * This method calls {@link dataBind} if the data source is specified

+	 * by {@link setDataSourceID} or if {@link getRequiresDataBinding RequiresDataBinding}

+	 * is true.

+	 */

+	protected function ensureDataBound()

+	{

+		try

+		{

+			$this->_throwOnDataPropertyChange=true;

+			if($this->_requiresDataBinding && ($this->getUsingDataSourceID() || $this->_requiresBindToNull))

+			{

+				$this->dataBind();

+				$this->_requiresBindToNull=false;

+			}

+		}

+		catch(Exception $e)

+		{

+			$this->_throwOnDataPropertyChange=false;

+			throw $e;

+		}

+	}

+

+	/**

+	 * Raises <b>DataBound</b> event.

+	 * This method should be invoked after a databind is performed.

+	 * It is mainly used by framework and component developers.

+	 */

+	public function onDataBound($param)

+	{

+		$this->raiseEvent('DataBound',$this,$param);

+	}

+

+	/**

+	 * Sets page's <b>PreLoad</b> event handler as {@link onPagePreLoad}.

+	 * If viewstate is disabled and the current request is a postback,

+	 * {@link setRequiresDataBinding RequiresDataBinding} will be set true.

+	 * This method overrides the parent implementation.

+	 * @param TEventParameter event parameter

+	 */

+	protected function onInit($param)

+	{

+		parent::onInit($param);

+		$page=$this->getPage();

+		$page->attachEventHandler('PreLoad',array($this,'onPagePreLoad'));

+		if(!$this->getEnableViewState(true) && $page->getIsPostBack())

+			$this->setRequiresDataBinding(true);

+	}

+

+	/**

+	 * Sets {@link getInitialized} as true.

+	 * This method is invoked when page raises <b>PreLoad</b> event.

+	 * @param mixed event sender

+	 * @param TEventParameter event parameter

+	 */

+	protected function onPagePreLoad($sender,$param)

+	{

+		$this->_initialized=true;

+	}

+

+	/**

+	 * Ensures any pending databind is performed.

+	 * This method overrides the parent implementation.

+	 * @param TEventParameter event parameter

+	 */

+	protected function onPreRender($param)

+	{

+		$this->_prerendered=true;

+		$this->ensureDataBound();

+		parent::onPreRender($param);

+	}

+

+	/**

+	 * Validates if the parameter is a valid data source.

+	 * @return boolean if the parameter is a valid data source

+	 */

+	protected function validateDataSource($value)

+	{

+		if(!is_array($value) && !($value instanceof Traversable))

+			throw new TInvalidDataTypeException('databoundcontrol_datasource_invalid');

+	}

+

+	/**

+	 * @return ???

+	 */

+	protected function performSelect()

+	{

+		if(!$this->getUsingDataSourceID())

+			$this->onDataBinding(null);

+		$view=$this->getDataSourceView();

+		$this->setRequiresDataBinding(false);

+		$this->setDataBound(true);

+		$data=$view->select($this->getSelectParameters());

+		if($this->getUsingDataSourceID())

+			$this->onDataBinding(null);

+		$this->performDataBinding($data);

+		$this->onDataBound(null);

+	}

+

+	protected function getDataSourceView()

+	{

+		$source=$this->getDataSourceByID();

+		return $source->getView($this->getDataMember());

+	}

+

+	protected function performDataBinding($data)

+	{

+	}

+

+	public function getDataMember()

+	{

+		return $this->getViewState('DataMember','');

+	}

+

+	public function setDataMember($value)

+	{

+		$this->setViewState('DataMember',$value,'');

+	}

+

+	public function getSelectParameters()

+	{

+		if(!$this->_parameters)

+			$this->_parameters=$this->createSelectParameters();

+		return $this->_parameters;

+	}

+

+	protected function createSelectParameters()

+	{

+		return new TDataSourceSelectParameters;

+	}

+}

+

+?>
\ No newline at end of file
diff --git a/framework/Web/UI/WebControls/TDropDownList.php b/framework/Web/UI/WebControls/TDropDownList.php
new file mode 100644
index 00000000..07549c6c
--- /dev/null
+++ b/framework/Web/UI/WebControls/TDropDownList.php
@@ -0,0 +1,42 @@
+<?php

+

+class TDropDownList extends TListControl implements IPostBackDataHandler

+{

+	protected function addAttributesToRender($writer)

+	{

+		$writer->addAttribute('name',$this->getUniqueID());

+		parent::addAttributesToRender($writer);

+	}

+

+	public function loadPostData($key,$values)

+	{

+		if(!$this->getEnabled(true))

+			return false;

+		// ensure DataBound???

+	}

+

+	public function raisePostDataChangedEvent()

+	{

+		$page=$this->getPage();

+		if($this->getAutoPostBack() && !$page->getPostBackEventTarget())

+		{

+			$page->setPostBackEventTarget($this);

+			if($this->getCausesValidation())

+				$page->validate($this->getValidationGroup());

+		}

+		$this->onSelectedIndexChanged(null);

+	}

+

+	public function getSelectedIndex()

+	{

+		$index=parent::getSelectedIndex();

+		if($index<0 && $this->getItems()->getCount()>0)

+		{

+			$this->setSelectedIndex(0);

+			return 0;

+		}

+		else

+			return $index;

+	}

+}

+?>
\ No newline at end of file
diff --git a/framework/Web/UI/WebControls/TListBox.php b/framework/Web/UI/WebControls/TListBox.php
new file mode 100644
index 00000000..79afc133
--- /dev/null
+++ b/framework/Web/UI/WebControls/TListBox.php
@@ -0,0 +1,86 @@
+<?php

+

+class TListBox extends TListControl implements IPostBackDataHandler

+{

+	protected function addAttributesToRender($writer)

+	{

+		$rows=$this->getRows();

+		$writer->addAttribute('size',"$rows");

+		$writer->addAttribute('name',$this->getUniqueID());

+		parent::addAttributesToRender($writer);

+	}

+

+	protected function onPreRender($param)

+	{

+		parent::onPreRender($param);

+		if($this->getSelectionMode()==='Multiple' && $this->getEnabled(true))

+			$this->getPage()->registerRequiresPostData($this);

+	}

+

+	public function loadPostData($key,$values)

+	{

+		if(!$this->getEnabled(true))

+			return false;

+		// ensure DataBound???

+	}

+

+	public function raisePostDataChangedEvent()

+	{

+		$page=$this->getPage();

+		if($this->getAutoPostBack() && !$page->getPostBackEventTarget())

+		{

+			$page->setPostBackEventTarget($this);

+			if($this->getCausesValidation())

+				$page->validate($this->getValidationGroup());

+		}

+		$this->onSelectedIndexChanged(null);

+	}

+

+	protected function getIsMultiSelect()

+	{

+		return $this->getSelectionMode()==='Multiple';

+	}

+

+	public function getSelectedIndices()

+	{

+		return parent::getSelectedIndices();

+	}

+

+	/**

+	 * @return integer the number of rows to be displayed in the component

+	 */

+	public function getRows()

+	{

+		return $this->getViewState('Rows', 4);

+	}

+

+	/**

+	 * Sets the number of rows to be displayed in the component

+	 * @param integer the number of rows

+	 */

+	public function setRows($value)

+	{

+		$value=TPropertyValue::ensureInteger($value);

+		if($value<=0)

+			$value=4;

+		$this->setViewState('Rows', $value, 4);

+	}

+

+	/**

+	 * @return string the selection mode (Single, Multiple )

+	 */

+	public function getSelectionMode()

+	{

+		return $this->getViewState('SelectionMode', 'Single');

+	}

+

+	/**

+	 * Sets the selection mode of the component (Single, Multiple)

+	 * @param string the selection mode

+	 */

+	function setSelectionMode($value)

+	{

+		$this->setViewState('SelectionMode',TPropertyValue::ensureEnum($value,array('Single','Multiple')),'Single');

+	}

+}

+?>
\ No newline at end of file